imageQuantize

Home > Books > NetKernel API and Services Reference > Accessor Listing > Image Resource Model > imageQuantize

Module

The imageQuantize accessor is exported by the urn:org:ten60:util:image module. Import this module to gain access to the accessor.

Syntax

URI

active:imageQuantize

Argument	Rules	Description
operand	Mandatory	the Java bitmap image
operator	Mandatory	A format document with the size of colour palette to use

Example Usage

DPML

<instr>
  <type>imageQuantize</type>
  <operand>var:myimage</operand>
  <operator>
    <imageQuantize>
      <palette>100</palette>
    </imageQuantize>
  </operator>
  <target>this:response</target>
</instr>

NetKernel Foundation API

req=context.createSubRequest("active:imageQuantize");
req.addArgument("operand", [resource representation, aspect, or URI] );
req.addArgument("operator", [resource representation, aspect, or URI] );
result=context.issueSubRequest(req);

Purpose

Quantizes an image reducing the colour palette size to the value specified by the operator. Very valuable for significantly reducing the size of an image for delivery over the web with little loss of quality.

The operator document specifies the palette size. Its syntax is

<imageQuantize>
  <palette>100</palette>
</imageQuantize>

imageQuantize accepts and returns an ImageAspect resource which holds a Java AWT bitmap image and can be pipelined into any other image tool.