Chapter 7 - Class Snow.Snowbnd Methods

This chapter describes the available methods for the Snow.Snowbnd class. The chapter contains the following topics:

‘‘display_angle(int)’’

‘‘finalize(void)’’

‘‘fit_to_height(int)’’

‘‘fit_to_width(int)’’

‘‘getBitsPerPixel(void)’’

‘‘get_fit_to_height()’’

‘‘get_fit_to_width()’’

‘‘getHeight(void)’’

‘‘getInitialZoom(int, int)’’

‘‘getWidth(void)’’

‘‘getXdpi(void)’’

‘‘getYdpi(void)’’

‘‘IMG_antique_effect(void)’’

‘‘IMG_color_gray(void)’’

‘‘IMG_create_thumbnail(int, int)’’

‘‘IMG_decompress_bitmap(String, int)’’

‘‘IMG_decompress_bitmap(java.awt.Image, int)’’

‘‘IMG_decompress_bitmap(java.io.DataInputStream, int)’’

‘‘IMG_decompress_bitmap_fd(String, int, int)’’

‘‘IMG_decompress_bitmap_stream(String, int)’’

‘‘IMG_decompress_bitmap_stream_onthefly(String, int, java.awt.Container)’’

‘‘IMG_decompress_fax(java.lang.String, int, int, int, int, int)’’

‘‘IMG_decompress_fax(java.io.DataInputStream, int, int, int, int, int)’’

‘‘IMG_decompress_multipage_bitmap_stream_onthefly(String, int, java.awt.Container)’’

‘‘IMG_deskew_bitmap(int)’’

‘‘IMG_despeckel_bitmap(int)’’

‘‘IMG_diffusion_mono(void)’’

‘‘IMG_display_bitmap(java.awt.Graphics, int, int, int, int)’’

‘‘IMG_display_bitmap_aspect(java.awt.Graphics, java.awt.Container, int, int, int, int, int)’’

‘‘IMG_display_bitmap_smooth(java.awt.Graphics, java.awt.Container, int, int, int, int, int)’’

‘‘IMG_erase_rect(int, int, int, int, int, int, int)’’

‘‘IMG_fill_bitmap_pattern(int, int, int, int, int, int, int, int, byte[])’’

‘‘IMG_flip_bitmapx(void)’’

‘‘IMG_flip_bitmapy(void)’’

‘‘IMG_get_bitmap_block(int, int, int, int)’’

‘‘IMG_get_deskew_angle(int[], int, int)’’

‘‘IMG_invert_bitmap(void)’’

‘‘IMG_merge_block(Snow.Snowbnd, int, int, int)’’

‘‘IMG_print_applet(java.awt.Container, int)’’

‘‘IMG_print_applet_pages(java.awt.Container, int)’’

‘‘IMG_print_bitmap(java.awt.Graphics, int, int, int, int, int)’’

‘‘IMG_promote_24(void)’’

‘‘IMG_remove_red_eye(int, int, int, int)’’

‘‘IMG_resize_bitmap(int, int)’’

‘‘IMG_resize_bitmap_bicubic(int, int)’’

‘‘IMG_resize_to_gray(int, int)’’

‘‘IMG_rgb_to_cmyk(void)’’

‘‘IMG_rotate_bitmap(int)’’

‘‘IMG_save_bitmap(byte, int)’’

‘‘IMG_save_bitmap(String, int)’’

‘‘IMG_scroll_bitmap(java.awt.Container, java.awt.Event)’’

‘‘IMG_set_croprect(int, int, int, int)’’

‘‘IMG_shift_bitmap(int, int)’’

‘‘IMG_window_level(int, int, int)’’

‘‘IMGLOW_extract_text(String, int, int, int)’’

‘‘IMGLOW_get_brightness()’’

‘‘IMGLOW_get_contrast()’’

‘‘IMGLOW_get_fileinfo(java.io.DataInputStream, int)’’

‘‘IMGLOW_get_filetype(String)’’

‘‘IMGLOW_get_filetype(java.io.DataInputStream)’’

‘‘IMGLOW_get_gamma()’’

‘‘IMGLOW_get_image_orientation(void)’’

‘‘IMGLOW_get_pages(java.io.DataInputStream)’’

‘‘IMGLOW_get_pages(String)’’

‘‘IMGLOW_get_raster(int, byte[])’’

‘‘IMGLOW_get_tiff_tag(int, int, int[], java.io.DataInputStream, byte[], int) IMGLOW_get_tiff_tag(int, int, int[], String, byte[], int)’’

‘‘IMGLOW_put_raster(int, byte[])’’

‘‘IMGLOW_search_text(byte[], String, int, int, int[])’’

‘‘IMGLOW_set_ascii_attributes(int, int, int, int, int, int, int, int, int, int, int, int, boolean, boolean, String, int, double)’’

‘‘IMGLOW_set_brightness(int)’’

‘‘IMGLOW_set_comp_quality(int)’’

‘‘IMGLOW_set_contrast(int)’’

‘‘IMGLOW_set_decompsize(int, int)’’

‘‘IMGLOW_set_decomp_rect(int, int, int, int)’’

‘‘IMGLOW_set_document_input(int, int)’’

‘‘IMGLOW_set_gamma(int)’’

‘‘IMGLOW_set_image_orientation(int)’’

‘‘IMGLOW_set_jpg_interleave(int, int)’’

‘‘IMGLOW_set_overlay_path(String)’’

‘‘IMGLOW_set_pcl_input(int, int)’’

‘‘IMGLOW_set_pdf_input(int, int)’’

‘‘IMGLOW_set_pdf_output(int, int)’’

‘‘IMGLOW_set_tiff_tag(int, int, int, byte[])’’

‘‘IMGLOW_write_tiff_stream(Dib_Head lpbi, byte, int, int, String)’’

‘‘map_image_to_wnd(java.awt.Container, java.awt.Point)’’

‘‘map_wnd_to_image(java.awt.Container, java.awt.Point)’’

‘‘set_croprect(int, int, int, int)’’

‘‘set_croprect_scroll(java.awt.Container, int, int, int, int, int)’’

‘‘setFrame(java.awt.Container)’’

‘‘setXdpi(int)’’

‘‘setYdpi(int)’’

‘‘Snowbnd(int, int, int)’’

‘‘Snowbnd(Snowbnd)’’

display_angle(int)

This method rotates the image at display time. The data itself is not changed, but the image is painted at the requested angle. This method is extremely fast, and is the recommended method for rotating when it is unnecessary to permanently change the image data.

See ‘‘IMG_rotate_bitmap(int)’’ for more information.

Syntax

void display_angle(int angle);

Remark

Table 7-1 lists the display_angle(int) method setting descriptions.

_________________________________________________________________________

Example

if (myPanel.Simage != null)
{
      myPanel.Simage.display_angle(0);
      myPanel.repaint();
}

________________________________________________________________________

finalize(void)

This method is a recommended call when a Snowbnd object is no longer needed.

Syntax

void finalize();

fit_to_height(int)

This method turns on an internal flag that forces the IMG_display_bitmap_aspect method to display by fitting the width of the image to the height of the Container, minus the height of the scroll bars, if any.

See ‘‘IMG_display_bitmap_aspect(java.awt.Graphics, java.awt.Container, int, int, int, int, int)’’ for more information.

Syntax

void fit_to_height(int flag);

Remark

Table 7-2 lists the fit_to_height(int) method variable descriptions.

_________________________________________________________________________

Example

myPanel1.zoom = 0;
myPanel1.Simage.fit_to_height(1);
myPanel1.repaint();

_________________________________________________________________________

fit_to_width(int)

This method turns on an internal flag that forces the IMG_display_bitmap_aspect method to display by fitting the width of the image to the width of the Container, minus the width of the scroll bars, if any.

See ‘‘IMG_display_bitmap_aspect(java.awt.Graphics, java.awt.Container, int, int, int, int, int)’’ for more information.

Syntax

void fit_to_width(int flag);

Remark

Table 7-3 lists the fit_to_width(int) method setting descriptions.

_________________________________________________________________________

Example

myPanel1.zoom = 0;
myPanel1.Simage.fit_to_width(1);
myPanel1.repaint();

_________________________________________________________________________

getBitsPerPixel(void)

This method returns the bit depth of the image. See Appendix D for more information on the number of bits per pixel of your image.

Syntax

int getBitsPerPixel();

Returns

Integer. Any positive value (as well as 0) is a valid return.

get_fit_to_height()

This method returns the value set by fit_to_height(int).

Syntax

int get_fit_to_height();

Returns

Integer. It returns a 0 if off or 1 if on.

get_fit_to_width()

This method returns the value set by fit_to_width(int).

Syntax

int get_fit_to_width();

Returns

Integer. It returns a 0 if off or 1 if on.

getHeight(void)

This method returns the height of the image in pixels.

Syntax

int getHeight();

Returns

Integer. Any positive value (as well as 0) is a valid return.

getInitialZoom(int, int)

This method calculates the first zoom increment given the image’s height and width. Sometimes images are smaller than the containers in which they display. In that case, the image fits into the container either by height or width. The zoom increment is simply the ratio of screen pixels to image pixels.

For example, if this method returns 35, two zoom operations with a normal zoom increment of 25 are required before the image is noticeably zoomed.

Syntax

int getInitialZoom(int xsize, int ysize);

Remark

Table 7-4 lists the getInitialZoom(int, int) method variable descriptions.

getWidth(void)

This method returns the width of the image in pixels.

Syntax

int getWidth();

Returns

Integer. Any positive value (as well as 0) is a valid return.

getXdpi(void)

This method returns the X resolution, in dpi (dots per inch), of the image.

Syntax

int getXdpi();

Returns

Integer. Any positive value (as well as 0) is a valid return.

getYdpi(void)

This method returns the Y resolution, in dpi (dots per inch), of the image.

Syntax

int getYdpi();

Returns

Integer. Any positive value (as well as 0) is a valid return.

IMG_antique_effect(void)

This method converts color images to look as though they are antique photos. It replaces colors with sepia tones, which are reddish brown monochrome tints. When applied to a photo, they give the picture a warm, antique feeling.

Syntax

int IMG_antique_effect();

IMG_color_gray(void)

This method converts 24-bit color images to 8-bit gray scale images.

Syntax

int IMG_color_gray();

IMG_create_thumbnail(int, int)

This method intelligently resizes down images. It supports any pixel depth and chooses IMG_resize_bicubic for color images or IMG_resize_to_gray for 1-bit black and white images. This method is excellent for creating thumbnails.

Syntax

int IMG_create_thumbnail(int xsize, int ysize);

Remark

Table 7-5 lists the IMG_create_thumbnail(int, int) method variable descriptions.

IMG_decompress_bitmap(String, int)

This method decompresses an image from the local disk. This standard method can be used by applications, signed applets, or applets for which disk read permissions have been granted. As with all decompression methods, it automatically detects the file format.

Syntax

int IMG_decompress_bitmap(String st, int page);

Remark

Table 7-6 lists the IMG_decompress_bitmap(String, int) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

_________________________________________________________________________

Example

FileDialog fd = new FileDialog(this,"Open " +      "Bitmap",FileDialog.LOAD);
fd.show();
FileName = fd.getDirectory() + fd.getFile();
if (FileName != null)
{
      tSimage = new Snow.Snowbnd();
      tSimage.IMG_decompress_bitmap(FileName,0);
}
_________________________________________________________________________

IMG_decompress_bitmap(java.awt.Image, int)

This method imports a Java™ image object.

Syntax

int IMG_decompress_bitmap(java.awt.Image img, int bits_pix);

Remark

Table 7-7 lists the IMG_decompress_bitmap(java.awt.Image, int) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

_________________________________________________________________________

Example

java.awt.Image img;
int xsize, ysize;

if (myPanel1.Simage == null && myPanel1.Sann == null) return;

xsize = myPanel1.Simage.getWidth();
ysize = myPanel1.Simage.getHeight();
img = this.createImage(xsize,ysize);
Graphics g = img.getGraphics();
myPanel1.Simage.IMG_decompress_bitmap(img,1);
myPanel1.Simage.IMG_display_bitmap(g,0,0,xsize,ysize);
myPanel1.Sann = null;
myPanel1.repaint(),

_________________________________________________________________________

IMG_decompress_bitmap(java.io.DataInputStream, int)

This method decompresses data from a DataInputStream and automatically detects the file format.

Syntax

int IMG_decompress_bitmap(java.io.DataInputStream di, int page);

Remark

Table 7-8 lists the IMG_decompress_bitmap(java.io.DataInputStream, int) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

_________________________________________________________________________

Example

java.io.RandomAccessFile ras;
int length;
byte buff[];
try
{
      ras = new java.io.RandomAccessFile (st,"r");
      length = (int)ras.length();
      buff = new byte[length];
      ras.readFully(buff,0,length);
}
catch (IOException ioe)
{
      return -2;
}
java.io.DataInputStream di;
di = new java.io.DataInputStream(new java.io.ByteArrayInputStream(buff))
stat = tSimage.IMG_decompress_bitmap(di, page);

_________________________________________________________________________

IMG_decompress_bitmap_fd(String, int, int)

This method works the same as IMG_decompress_bitmap but can be used for image formats that are embedded in a larger file and do not start at the beginning of a file.

Syntax

int IMG_decompress_bitmap_fd(String bm_name, int offset, int page);

Remark

Table 7-9 lists the IMG_decompress_bitmap_fd(String, int, int) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

IMG_decompress_bitmap_stream(String, int)

This method reads images from a standard URL. This method automatically detects the file format and is normally used by applets.

Syntax

int IMG_decompress_bitmap_stream(String st, int page);

Remark

Table 7-10 lists the IMG_decompress_bitmap_stream(String, int) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

IMG_decompress_bitmap_stream_onthefly(String, int, java.awt.Container)

This method decompresses and displays partially downloaded image data from a URL. The image begins to display even before all image data is downloaded.

This special method is used by applets. As with all decompression methods, it automatically detects the file format.

Syntax

int IMG_decompress_bitmap_stream_onthefly(String st, int page, java.awt.Container sf);

Remark

Table 7-11 lists the IMG_decompress_bitmap_stream_onthefly(String, int, java.awt.Container) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

IMG_decompress_fax(java.lang.String, int, int, int, int, int)

This method decompresses compressed fax data from proprietary image file formats which use the CCITT G3 or G4 compression algorithms. The path name is the absolute path to the file.

The developer is responsible for reading any header information such as height, width, fill order, or compression. Call this function to decompress the data and convert it into a Snow.DIB in memory.

Syntax

int IMG_decompress_fax(String bm_name, int xsize, int ysize, int type, int fill_order, int offset);

Remark

Table 7-12 lists the IMG_decompress_fax(java.lang.String, int, int, int, int, int) method variable descriptions.

Returns

Integer

IMG_decompress_fax(java.io.DataInputStream, int, int, int, int, int)

This method decompresses fax or proprietary image formats which use the CCITT G3 or G4 compression algorithms.

The developer is responsible for reading any header information such as height, width, fill order, or compression. Call this function to decompress the data and convert it into a Snow.DIB in memory.

Syntax

int IMG_decompress_fax(java.io.DataInputStream di, int xsize, int ysize, int type, int fill_order, int offset);

Remark

Table 7-13 lists the IMG_decompress_fax(java.io.DataInputStream, int, int, int, int, int) method variable descriptions.

Returns

Integer

IMG_decompress_multipage_bitmap_stream_onthefly(String, int, java.awt.Container)

This method decompresses and displays partially downloaded image data from a URL. The image begins to display even before all image data is downloaded. After the first page is decompressed and downloaded, the other pages of a multipage file are downloaded in the background. This allows subsequent pages to be available faster.

This special method is used by applets. As with all decompression methods, it automatically detects the file format.

Syntax

int IMG_decompress_multipage_bitmap_stream_onthefly(String st, int page, java.awt.Container sf);

Remark

Table 7-14 lists the IMG_decompress_multipage_bitmap_stream_onthefly(String, int, java.awt.Container) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

IMG_deskew_bitmap(int)

This method is a fast rotate for 1-bit skewed images. Use this method after IMG_get_deskew_angle returns a skew angle. This method rotates only from -45 to 45 degrees, but is much faster than IMG_rotate_bitmap for 1-bit images. For best results, use values of -20 to 20.

See ‘‘IMG_get_bitmap_block(int, int, int, int)’’ and ‘‘IMG_rotate_bitmap(int)’’ for more information.

Syntax

int IMG_deskew_bitmap(int rot_angle);

Remark

Table 7-15 lists the IMG_deskew_bitmap(int) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

IMG_despeckel_bitmap(int)

This method removes noise (random pixel data) from 1-bit images. This method works only with 1-bit images. The quality variable can accept a range of 100 values.

Syntax

int IMG_despeckel_bitmap(int quality);

Remark

Table 7-16 lists the IMG_despeckel_bitmap(int) method setting descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

IMG_diffusion_mono(void)

This method converts 4, 8, or 24 bit images to 1-bit per pixel bi-level images.

Syntax

int IMG_diffusion_mono();

Returns

Integer. Any positive value (as well as 0) is a valid return.

IMG_display_bitmap(java.awt.Graphics, int, int, int, int)

This method displays the current image at the current X and Y coordinates, and is not corrected for aspect ratio. To use RasterMaster’s automatic aspect ratio correction during display, use IMG_display_bitmap_aspect.

See ‘‘IMG_display_bitmap_aspect(java.awt.Graphics, java.awt.Container, int, int, int, int, int)’’ for more information.

Syntax

int IMG_display_bitmap(Graphics g, int xpos, int ypos, int xsize, int ysize);

Remark

Table 7-17 lists the IMG_display_bitmap(java.awt.Graphics, int, int, int, int) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

IMG_display_bitmap_aspect(java.awt.Graphics, java.awt.Container, int, int, int, int, int)

This method displays the current image, corrected for aspect ratio, at the current X and Y coordinates. It also displays scroll bars if the image is zoomed (zoom != 0 and zoom > Snowbnd.getInitialZoom()).

RasterMaster automatically detects whether or not Swing is present, and uses the correct scroll bar for AWT or Swing.

Syntax

int IMG_display_bitmap_aspect(Graphics g, Container f, int xpos, int ypos, int xsize, int ysize, int zoom);

Remark

Table 7-18 lists the IMG_display_bitmap_aspect(java.awt.Graphics, java.awt.Container, int, int, int, int, int) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

_________________________________________________________________________

Example

public void paint (Graphics g)
{
      if (Simage != null)
      {
      in = getInsets();
         /* NOTE THAT Microsoft JVIEW.EXE has a bug and does not
         start the origin at 0,0 under the title bar. Comment this
         next line to fix Jview.exe. All other Java Machines work
         fine.*/
      g.translate(in.left, in.top);

            d = getSize();
            d.width = (in.right + in.left);
            d.height = (in.top + in.bottom);

      if (cropped == 0)
            stat =
             Simage.IMG_display_bitmap_aspect(g, this,
               0,0,d.width,d.height, zoom);
         else

            Simage.IMG_display_bitmap(g,0,0,d.width,d.height);
      if (select)
            snbd_draw_pen();
      }
}

_________________________________________________________________________

IMG_display_bitmap_smooth(java.awt.Graphics, java.awt.Container, int, int, int, int, int)

This method displays the current image, corrected for aspect ratio, at the current X and Y coordinates. The zoom value is a percentage of the image display to the container size. A value of zero will fill the current container with a best fit, either fit to width or fit to height. For example, a value of 10 will zoom the image 10% larger than the container size. This will crop the image slightly. A negative value will shrink the image by the percentage and center in the container.  

Syntax

int IMG_display_bitmap_smooth(Graphics hdc, Container sf, int xs, int ys, int xsize, int ysize, int zoom);

Remark

Table 7-19 lists the IMG_display_bitmap_smooth(java.awt.Graphics, java.awt.Container, int, int, int, int, int) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

_________________________________________________________________________

Example

public void paint (Graphics g)
{
      if (Simage != null)
      {
d = getSize();
in = getInsets();
d.width -= (in.right + in.left);
d.height -= (in.top + in.bottom);

      in = getInsets();
         /* NOTE THAT Microsoft JVIEW.EXE has a bug and does not
         start the origin at 0,0 under the title bar. Comment this
         next line to fix Jview.exe. All other JVMs work
         fine.*/
      g.translate(in.left, in.top);

            stat = Simage.IMG_display_bitmap_smooth(g, this, 0, 0, d.width,  
d.height,zoom);
}
}
public void update(Graphics g)
{
// If the container is showing, be sure to repaint it, otherwise
// repainting it is unnecessary and will cause update flashing
if ((Simage == null) || (Simage.dis_crop_xe == Simage.dis_width)
|| (Simage.dis_crop_ye == Simage.dis_height))
{
       g.setColor(getBackground());
       g.fillRect(0, 0, d.width, d.height);
       g.setColor(getForeground());
}

     paint(g);

}

_________________________________________________________________________

IMG_erase_rect(int, int, int, int, int, int, int)

This method fills the inside or outside of the specified rectangle (xs, ys, xsize, and ysize parameters) with the color passed in. It can be used to remove borders, for instance.

For 24-bit images, the color value must be a RGB-packed pixel; 1 byte red, 1 byte green, and 1 byte blue. For 1-bit black and white images, only the least significant bit is used.

Syntax

int IMG_erase_rect(int xs, int ys, int xsize, int ysize, int color, int in_outflag, int operation);

Remark

Table 7-20 lists the IMG_erase_rect(int, int, int, int, int, int, int) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

_________________________________________________________________________

Example

if (ssb.Simage != null)
{
      int width = ssb.Simage.getWidth();
      int height = ssb.Simage.getHeight();
   
         ssb.Simage.IMG_erase_rect(width / 20, height / 20,
         width (width / 10), height (height / 10),0xffffffff,
         0, 0);
}
repaint();

_________________________________________________________________________

IMG_fill_bitmap_pattern(int, int, int, int, int, int, int, int, byte[])

This method allows filling an area of a bitmap with specified patterns found in the pattern argument.

Syntax

int IMG_fill_bitmap_pattern(int xs, int ys, int xsize, int ysize, int pattern_width, int pattern_height, int x_offset, int y_offset, int byte pattern[]);

Remark

Table 7-21 lists the IMG_fill_bitmap_pattern(int, int, int, int, int, int, int, int, byte[]) method variable descriptions.

IMG_flip_bitmapx(void)

This method flips the image horizontally to produce a mirror image. Positive X coordinates along the X-axis are swapped with negative X coordinates, and vice versa.

Syntax

int IMG_flip_bitmapx();

Returns

Integer. Any positive value (as well as 0) is a valid return.

IMG_flip_bitmapy(void)

This method flips the image vertically to produce a mirror image. Positive Y coordinates along the Y-axis are swapped with negative Y coordinates, and vice versa.

Syntax

int IMG_flip_bitmapy();

Returns

Integer. Any positive value (as well as 0) is a valid return.

IMG_get_bitmap_block(int, int, int, int)

This method returns a block of data from the current image and creates a Snowbnd object, where the data is specified by the rectangle constructed from the image’s coordinates. The image can then be displayed, rotated, saved, and more.

Syntax

Snow.Snowbnd IMG_get_bitmap_block(int xs, int ys, int xsize, int ysize);

Remark

Table 7-21 lists the Snow.Snowbnd IMG_get_bitmap_block(int, int, int, int) method variable descriptions.

Returns

A new Snowbnd object

IMG_get_deskew_angle(int[], int, int)

This method returns the skew angle for 1-bit images. When scanning multiple pages, images are often slightly skewed or rotated. The values returned in the p_angle[] array should be passed to IMG_deskew_bitmap.

See ‘‘IMG_deskew_bitmap(int)’’ for more information.

Syntax

int IMG_get_deskew_angle(int p_angle[], int start_angle, int end_angle);

Remark

Table 7-23 lists the IMG_get_deskew_angle(int[], int, int) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

_________________________________________________________________________

Example

if (Simage != null)
      stat =
         Simage.IMG_get_deskew_angle(pangle, -15, 15);

if (stat >= 0 && pangle[0] != 0)
{
      Simage.IMG_deskew_bitmap(pangle[0]);
      repaint();
}

_________________________________________________________________________

IMG_invert_bitmap(void)

This method inverts the current image, changing pixels by a simple XOR operation applied to each byte of the image in memory. For bi-level images, this method changes black to white and white to black.

Syntax

int IMG_invert_bitmap(void);

Returns

Integer. Any positive value (as well as 0) is a valid return.

IMG_merge_block(Snow.Snowbnd, int, int, int)

This method draws a source image on top of the current image at the x and y coordinates (xpos and ypos) passed in.

Syntax

int IMG_merge_block(Snowbnd shdib, int xpos, int ypos, int operation);

Remark

Table 7-24 lists the IMG_merge_block(Snow.Snowbnd, int, int, int) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

_________________________________________________________________________

Example

if (Simage != null)
{
      FileDialog fd = new FileDialog(this,"Open Bitmap",FileDialog.LOAD);
      fd.show();   

      FileName = fd.getDirectory() + fd.getFile();

      if (FileName != null)
      {
         tSimage = new Snow.Snowbnd();
         tSimage.IMG_decompress_bitmap(FileName,0);
         Simage.IMG_merge_block(tSimage,31,31,0);
         tSimage = null;
         System.gc();
      }
}

_________________________________________________________________________

IMG_print_applet(java.awt.Container, int)

This method prints images loaded into an applet. This method automatically determines in which browser the applet is being displayed, and performs high-resolution corrections for that browser. It also formats the document for high-resolution printing.

Syntax

int IMG_print_applet(Container C, int res);

Remark

Table 7-25 lists the IMG_print_applet(java.awt.Container, int) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

_________________________________________________________________________

Example

void button4_clicked(Event e)
      {
         IMG_print_applet(this, 300);
      }

_________________________________________________________________________

IMG_print_applet_pages(java.awt.Container, int)

This method prints high-resolution multipage documents from applets.

Syntax

int IMG_print_applet_pages(Container c, int res);

Remark

Table 7-26 lists the IMG_print_applet_pages(java.awt.Container, int) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

_________________________________________________________________________

Example

void button5_clicked(Event e)
      {
         //for a 3 page document
         for(int i = 0; i < 3; i++)
         {
                  Simage.IMG_decompress_bitmap_stream_onthefly(st,
            i,this);
            IMG_print_applet_pages(this, 300);
      }
      IMG_print_applet_pages(null, 0);
}

_________________________________________________________________________

IMG_print_bitmap(java.awt.Graphics, int, int, int, int, int)

This method prints the current image at the specified coordinates.

Syntax

int IMG_print_bitmap(Graphics g, int xs, int ys, int xsize, int ysize, int res);

Remark

Table 7-27 lists the IMG_print_bitmap(java. awt.Graphics, int, int, int, int, int) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

IMG_promote_24(void)

This method permanently converts the current 1, 4, or 8-bit image to a 24-bit image. This automatically disables anti-aliasing for 1-bit images.

Syntax

int IMG_promote_24();

Returns

Integer. Any positive value (as well as 0) is a valid return.

IMG_remove_red_eye(int, int, int, int)

This method detects and converts photos of people with very red eyes to more natural colors.

Syntax

int IMG_remove_red_eye(int xpos, int ypos, int xsize, int ysize);

Remarks

Table 7-28 lists the IMG_remove_red_eye(int, int, int, int) method variable descriptions.

IMG_resize_bitmap(int, int)

This method changes the internal size of the image according to the input parameters. The size of the source image is not relevant.

See ‘‘IMG_resize_bitmap_bicubic(int, int)’’ for important details on the algorithm (linear interpolation) used by this method, and for more details on creating high-quality thumbnails.

Syntax

int IMG_resize_bitmap(int hres, int vres);

Remark

Table 7-29 lists the IMG_resize_bitmap(int, int) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

IMG_resize_bitmap_bicubic(int, int)

This method scales down images using a bicubic interpolation algorithm. It is good for creating high-resolution color image thumbnails. Since this operation is floating-point intensive, it is not as fast as IMG_resize_bitmap which uses a linear interpolation.

Bicubic interpolation takes a four pixel by four pixel block and produces an average of those pixels by weighting the value of the pixel in the average based on its distance from the origin pixel. Pixels farther away have less effect on the resulting pixel’s value than do its nearest neighbors.

Linear interpolation takes two pixels, separated by x pixels, and averages the two pixels to create an in-between value. These three pixels (the two original pixels and the newly created in-between pixel), are used to represent the original x + 2 pixels (the two original pixels as end points plus all of the pixels in between).

Syntax

int IMG_resize_bitmap_bicubic(int xsize, int ysize);

Remark

Table 7-30 lists the IMG_resize_bitmap_bicubic(int, int) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

IMG_resize_to_gray(int, int)

This method resizes a 1-bit black and white image to a (smaller) 8-bit grayscale image. Use it for making thumbnail versions of documents or engineering drawings. It uses the anti-aliasing method of the display engine to create a high-quality thumbnail.

Syntax

int IMG_resize_to_gray(int xsize, int ysize);

Remark

Table 7-31 lists the IMG_resize_to_gray(int, int) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

IMG_rgb_to_cmyk(void)

This method converts the current image from 24-bit RGB data to 32-bit CMYK data. RasterMaster products support full 32-bit CMYK data as an internal 32-bit DIB format. The black plane is created.

Syntax

int IMG_rgb_to_cmyk();

Returns

Integer. Any positive value (as well as 0) is a valid return.

IMG_rotate_bitmap(int)

This method rotates the current image clockwise by display angle. This permanently rotates the image in memory. For fast rotation at display time (image is not altered in memory), call display_angle.

See ‘‘display_angle(int)’’ for more information.

Syntax

int IMG_rotate_bitmap(int angle);

Remark

Table 7-32 lists the IMG_rotate_bitmap(int) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

IMG_save_bitmap(byte, int)

This method saves the current Snowbnd image object to a byte array. Multipage saving to a byte array is supported for MO:DCA and TIFF only. There is no way to know how large the image will be once compressed.

See ‘‘IMG_save_bitmap(String, int)’’ and Filter Bit Level Support in Appendix D for more information.

Syntax

int IMG_save_bitmap(byte array[] b, int comp_type);

Remark

Table 7-33 lists the IMG_save_bitmap(byte, int) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is the size of the image in the array.

IMG_save_bitmap(String, int)

This method saves the current Snowbnd image object to the format specified by comp_type. The string value is the output file.

TIFF is a multipage file format. If the image name already exists, a new page or image is appended to the local file, leaving the current images unchanged. If the file does not exist, it is created with only one page.

Syntax

int IMG_save_bitmap(String st, int comp_type);

Remark

Table 7-34 lists the IMG_save_bitmap(String, int) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

IMG_scroll_bitmap(java.awt.Container, java.awt.Event)

This method scrolls the bitmap. It essentially moves the current cropping rectangle in the direction indicated by the ScrollBar thumb. For users who do not want the scrollbars visible, a similar effect can be achieved by moving the cropping rectangle around using IMG_set_croprect.

See ‘‘IMG_set_croprect(int, int, int, int)’’ for more information.

Syntax

int IMG_scroll_bitmap(Container sf, Event evt);

Remark

Table 7-35 lists the IMG_scroll_bitmap(java.awt.Container, java.awt.Event) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

_________________________________________________________________________

Example

public boolean handleEvent (Event evt)
{
      switch(evt.id)
      {
         case Event.SCROLL_LINE_UP:
         case Event.SCROLL_LINE_DOWN:
         case Event.SCROLL_PAGE_UP:
         case Event.SCROLL_PAGE_DOWN:
         case Event.SCROLL_ABSOLUTE:
         {
            Simage.IMG_scroll_bitmap(this,evt);
            return true;
         }
      }

      return super.handleEvent(evt);
}

_________________________________________________________________________

IMG_set_croprect(int, int, int, int)

This method sets dis_crop_xs, dis_crop_xe, dis_crop_ys, and dis_crop_ye. The cropping rectangle is essentially the size of the display container (which is usually a subclass of java.awt.Container), mapped onto the image (corrected for image scaling).

To use cropping methods with zooming, see ‘‘map_wnd_to_image(java.awt.Container, java.awt.Point)’’ and ‘‘map_image_to_wnd(java.awt.Container, java.awt.Point)’’.

Syntax

void IMG_set_croprect(int xs, int ys, int xsize, int ysize);

Remark

Table 7-36 lists the IMG_set_croprect(int, int, int, int) method variable descriptions.

IMG_shift_bitmap(int, int)

This method shifts the image data along the x and y axes, positively or negatively according to the parameters passed in. Values are relative.

Syntax

int IMG_shift_bitmap(int xoffset, int yoffset);

Remark

Table 7-37 lists the IMG_shift_bitmap(int, int) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

IMG_window_level(int, int, int)

This method changes the range of displayed pixels. It performs window leveling in 8 and 16-bit gray scale images.

Syntax

int IMG_window_level(int min, int max, int on_off);

Remark

Table 7-38 lists the IMG_window_level(int, int, int) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

_________________________________________________________________________

Example

if (Simage.getBitsPerPixel() == 16)
      Simage.IMG_window_level(0,0,1);

_________________________________________________________________________

IMGLOW_extract_text(String, int, int, int)

This method extracts text from PTOCA, PCL, MS Word, AFP, and MS Excel files. Returns the buffer of extracted text in ASCII format.

Syntax

byte[] IMGLOW_extract_text(String bm_name, int length[], int error[], int page);

Remarks

Table 7-39 lists the IMGLOW_extract_text(String, int, int, int) method variable descriptions.

Returns

ASCII format.

___________________________________________________________________________

Example

%%SOF
/Page=0
/Width=1700
/Height=2200
/FontName=TimesRoman
/FontHeight=44
/FontBold=1
/FontItalic=0
/Xpos=1300 /Ypos=240
%%SOT
Devadas
%%EOT
/Xpos=1253 /Ypos=240
%%SOT
S.
%%EOT
%%EOF

___________________________________________________________________________

IMGLOW_get_brightness()

This method returns the current brightness set by IMGLOW_set_brightness(int). The default is 0. See ‘‘IMGLOW_set_brightness(int)’’for more information.

Syntax

int IMGLOW_get_brightness();

Returns

Integer. Any value between -127 and 127.

IMGLOW_get_contrast()

This method returns the current contrast set by IMGLOW_set_contrast(int). The default is 0. See ‘‘IMGLOW_set_contrast(int)’’ for more information.

Syntax

int IMGLOW_get_contrast();

Returns

Integer. Any value between -127 and 127.

IMGLOW_get_fileinfo(java.io.DataInputStream, int)

This method fills in the height, width, and bits-per-pixel without decompressing the entire file. After calling this method, you can call ‘‘getHeight(void)’’, ‘‘getWidth(void)’’, ‘‘getXdpi(void)’’, ‘‘getYdpi(void)’’, and ‘‘getBitsPerPixel(void)’’.

Syntax

int IMGLOW_get_fileinfo(java.io.DataInputStream di, int page);

Remark

Table 7-41 lists the IMGLOW_get_filetinfo(java.io.DataInputStream, int) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is the image type as defined in Snow.Defines, Appendix C.

IMGLOW_get_filetype(String)

This method returns the file type of an image. See Appendix B or our website (www.snowbound.com) for a current list of supported formats.

Syntax

int IMGLOW_get_filetype(String filename);

Remark

Table 7-42 lists the IMGLOW_get_filetype(String) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is the image type as defined in Snow.Defines, Appendix C.

IMGLOW_get_filetype(java.io.DataInputStream)

This method returns the filetype of an image. See Appendix B or our website (www.snowbound.com) for the most updated list of supported formats.

Syntax

int IMGLOW_get_filetype(DataInputStream dis);

Remark

Table 7-43 lists the IMGLOW_get_filetype(java.io.DataInputStream) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is the image type as defined in Snow.Defines, Appendix C.

IMGLOW_get_gamma()

This method returns the current gamma set by IMGLOW_set_gamma(int). The default is 100. See ‘‘IMGLOW_set_gamma(int)’’ for more information.

Syntax

int IMGLOW_get_gamma();

Returns

Integer. Any value between 0 and 400.

IMGLOW_get_image_orientation(void)

This method returns the orientation of the last image decompressed if the information is available. Orientation is used to determine the display angle.

Syntax

int IMGLOW_get_image_orientation();

Returns

Integer. Any positive value (as well as 0) is the orientation of the image.

IMGLOW_get_pages(java.io.DataInputStream)

This method returns the number of pages in a multipage document. It works for any multi-page format. See Appendix B or our website (www.snowbound.com) for a current list of supported formats.

Syntax

int IMGLOW_get_pages(DataInputStream dis);

Remark

Table 7-44 lists the IMGLOW_get_pages(java.io.DataInputStream) method variable descriptions.

Returns

Integer. Any positive value is the number of pages in the image.

IMGLOW_get_pages(String)

This method returns the number of pages in a multipage document. It works for any multi-page format. See Appendix B or our website (www.snowbound.com) for the most updated list of supported formats.

Syntax

int IMGLOW_get_pages(String filename);

Remark

Table 7-45 lists the IMGLOW_get_pages(String) method variable descriptions.

Returns

Integer. Any positive value is the number of pages in the image.

IMGLOW_get_raster(int, byte[])

This method returns the raster line specified by the position on the Y-axis into the array buffer. Data placed in the array is in the DIB format. This is one line of raw, uncompressed data.

Syntax

int IMGLOW_get_raster(int ypos, byte buff[]);

Remark

Table 7-46 lists the IMGLOW_get_raster(int, byte[]) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

IMGLOW_get_tiff_tag(int, int, int[], java.io.DataInputStream, byte[], int)

IMGLOW_get_tiff_tag(int, int, int[], String, byte[], int)

These methods read a TIFF tag from the file specified. The tag may be either a string returned in buff or an int, short, or byte returned in value.

Syntax

int IMGLOW_get_tiff_tag(int tag, int max_bytes, int[] value, String file, byte[] buff, int page);

int IMGLOW_get_tiff_tag(int tag, int max_bytes, int[] value, DataInputStream file, byte[] buff, int page);

Remark

Table 7-47 lists the IMGLOW_get_tiff_tag(int, int, int[], java.io.DataInputStream, byte[], int) and IMGLOW_get_tiff_tag(int, int, int[], String, byte[], int) method variable descriptions.

Returns

Dependent on how value variable is set.

IMGLOW_put_raster(int, byte[])

This method replaces the raster line specified on the Y-axis with the new image data in the array buffer. The data to replace it is in the DIB format. This is one line of raw uncompressed data.

See Format for Decompressed Images for more information regarding formats for decompressed images.

Syntax

int IMGLOW_put_raster(int ypos, byte buff[]);

Remark

Table 7-48 lists the IMGLOW_put_raster(int, byte[]) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

IMGLOW_search_text(byte[], String, int, int, int[])

The method returns an array of structures of classes of the type, SNBD_SEARCH_RESULT. For each class or structure there is an array of rectangles. This is to allow a search term to wrap to a new line requiring more than two rectangles to highlight.

The nCount parameter will be set to the number of rectangles required for each instance of a search term. The rectangles will be sorted from the top of the page to the bottom from the left side to the right.

Syntax

SNBD_SEARCH_RESULT[] IMGLOW_search_text(byte[] buffer, String search_String, int page, int error[]);

Remark

Table 7-49 lists the IMGLOW_search_text(byte[], String, int, int, int[]) method variable descriptions.

IMGLOW_set_ascii_attributes(int, int, int, int, int, int, int, int, int, int, int, int, boolean, boolean, String, int, double)

This method sets attributes for importing an Ascii file into the Java RasterMaster library.

Syntax

int IMGLOW_set_ascii_attributes(int xdpi, int ydpi, int lmargin, int rmargin, int tmargin, int bmargin, int tabs, int pwidth, int pheight, int psize, int charpline, int lineppage, boolean weigh, boolean ital, String fontName, int lnspacing, double charspacing);

Remark

Table 7-50 lists the IMGLOW_set_ascii_attributes(int, int, int, int, int, int, int, int, int, int, int, int, boolean, boolean, String, int, double) method setting descriptions.

IMGLOW_set_brightness(int)

This method sets the brightness of the current image.

Syntax

int IMGLOW_set_brightness(int value);

Remark

Table 7-51 lists the IMGLOW_set_brightness(int) method setting descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

IMGLOW_set_comp_quality(int)

This method sets the compression quality factor when saving JPEG images.

Syntax

int IMGLOW_set_comp_quality(int quality);

Remark

Table 7-52 lists the IMGLOW_set_comp_quality(int) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

IMGLOW_set_contrast(int)

This method sets the relative difference between the image’s black and white values.

Syntax

int IMGLOW_set_contrast(int value);

Remark

Table 7-53 lists the IMGLOW_set_contrast(int) method setting descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

IMGLOW_set_decompsize(int, int)

This method allows setting the destination size for an image being decompressed. At decompress time, the image is scaled to the destination x and y size. This destination size also represents the image size in pixels, as it is necessary to decompress using IMG_decompress_bitmap.

When the IMGLOW_set_alias parameter is set to 4, the above function uses the Bicubic interpolation algorithm for scaling the image smoothly. If the alias parameter is set to 0, the scaling is done by skipping pixels. There is no other processing of neighboring pixels.

Syntax

int IMGLOW_set_decompsize(int xsize, int ysize);

Remark

Table 7-54 lists the IMGLOW_set_decompsize(int, int) method setting descriptions.

IMGLOW_set_decomp_rect(int, int, int, int)

This method allows specifying a rectangle in the image to decompress. Only this portion of the image is stored in RasterMaster’s internal memory. To turn this method off, call the method with all parameters set to 0.

Syntax

int IMGLOW_set_decomp_rect(int xs, int ys, int xsize, int ysize);

Remarks

Table 7-55 lists the IMGLOW_set_decomp_rect(int, int, int, int) method setting descriptions.

IMGLOW_set_document_input(int, int)

This method allows document formats to be rendered in color or black and white. It also allows you to set the document size. It is used for the PDF, Word, Excel, PCL, and AFP formats.

Syntax

int IMGLOW_set_document_input(int dpi, int bits_pix);

Remarks

Table 7-56 lists the IMGLOW_set_document_input(int, int) method setting descriptions.

Returns

Integer

IMGLOW_set_gamma(int)

This method sets a gamma correction factor which corrects for the gamma or response curve of the monitor. This can drastically improve the quality of some gray scale or 24-bit images.

Syntax

int IMGLOW_set_gamma(int value);

Remark

Table 7-57 lists the IMGLOW_set_gamma(int) method setting descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

IMGLOW_set_image_orientation(int)

This method sets the orientation flag before saving images to the TIFF format. Orientation changes the default display angle for the image.

See the TIFF 6.0 specification (http://www.adobe.com) for the meaning of the orientation flag.

Syntax

int IMGLOW_set_image_orientation(int orient);

Remark

Table 7-58 lists the IMGLOW_set_image_orientation(int) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

IMGLOW_set_jpg_interleave(int, int)

This method sets the JPEG interleave factor for writing JPEG images. This is the factor for decimating the blue and red chroma planes when writing out JPEG images.

Syntax

int IMGLOW_set_jpg_interleave(int h_int, int v_int);

Remark

Table 7-59 lists the IMGLOW_set_jpg_interleave(int, int) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

IMGLOW_set_overlay_path(String)

This method sets the path for finding overlay files. Some formats, such as MOD:CA, can contain references to overlay files. If set to null, overlay files will be ignored and only the bitmap will be decompressed.

Syntax

int IMGLOW_set_overlay_path(String st);

Remark

Table 7-60 lists the IMGLOW_set_overlay_path(String) method variable descriptions.

IMGLOW_set_pcl_input(int, int)

This method sets the rendering for PCL decompression. PCL files are rendered as a bitmap at decompression time. These values allow you to set the dots per inch and the pixel depth of the resulting bitmap.

Syntax

int IMGLOW_set_pcl_input(int dpi, int bits_pix);

Remark

Table 7-61 lists the IMGLOW_set_pcl_input(int dpi, int bits_pix) method variable descriptions.

IMGLOW_set_pdf_input(int, int)

This method allows the conversion of PDF files into bitmaps when decompressed by RasterMaster products. It allows the programmer to set the bitmap size and pixel depth of the resulting bitmap.

Syntax

int IMGLOW_set_pdf_input(int dpi, int bits_pix);

Remark

Table 7-62 lists the IMGLOW_set_pdf_input(int, int) method variable descriptions.

IMGLOW_set_pdf_output(int, int)

This method sets the destination size for saving PDF files. The xsize and ysize are the output sizes in points. A point is 1/72 of an inch.

Syntax

int IMGLOW_set_pdf_output(int xsize, int ysize);

Remark

Table 7-63 lists the IMGLOW_set_pdf_output(int, int) method variable descriptions.

IMGLOW_set_tiff_tag(int, int, int, byte[])

This method allows RasterMaster to write new and current tags. This method can be called multiple times for adding multiple tags to write.

Syntax

int IMGLOW_set_tiff_tag(int tag, int max_bytes, int value, byte buff[]);

Remarks

Table 7-64 lists the IMGLOW_set_tiff_tag(int, int, int, byte[]) method variable descriptions.

IMGLOW_write_tiff_stream(Dib_Head lpbi, byte, int, int, String)

This method is used to create a TIFF file with existing compressed data. The header information is passed as the Dib_Head class containing the width, height, and bits per pixel of the image to create.

Syntax

int IMGLOW_write_tiff_stream(Dib_Head lpbi, byte data_stream[], int data_size, int file_type, String bm_name);

Remarks

Table 7-65 lists the IMGLOW_write_tiff_stream(Dib_Head lpbi, byte data_stream[], int data_size, int file_type, String bm_name) method variable descriptions.

map_image_to_wnd(java.awt.Container, java.awt.Point)

This method converts image coordinates to screen coordinates for the currently displayed image. This is useful for converting mouse coordinates on the image to screen coordinates, as in creating a selection rectangle (rubber-band zoom).

Syntax

void map_image_to_wnd(java.awt.Container sf, java.awt.Point pt);

Remark

Table 7-66 lists the map_image_to_wnd(java.awt.Container, java.awt.Point) method variable descriptions.

map_wnd_to_image(java.awt.Container, java.awt.Point)

This method converts screen coordinates to image coordinates. This is valid only for the currently displayed image. This is useful for converting mouse coordinates on the screen to image coordinates, as in creating a selection rectangle (rubber-band zoom).

Syntax

void map_wnd_to_image(java.awt.Container sf, java.awt.Point pt);

Remark

Table 7-67 lists the map_wnd_to_image(java.awt.Container, java.awt.Point) method variable descriptions.

set_croprect(int, int, int, int)

This method sets the cropping rectangle for the display engine. Only the area of the image inside the current crop rectangle displays. Compare this to IMG_display_bitmap_aspect in which the zoom parameter simply sets the current crop rectangle.

See ‘‘IMG_display_bitmap_aspect(java.awt.Graphics, java.awt.Container, int, int, int, int, int)’’ for more information.

Syntax

int set_croprect(int xs, int ys, int xe, int ye);

Remark

Table 7-68 lists the set_croprect(int, int, int, int) method variable descriptions.

Returns

Integer. Any positive value (as well as 0) is a valid return.

set_croprect_scroll(java.awt.Container, int, int, int, int, int)

This method sets the rectangular area of an image to display and also sets up scrollbars. Scrollbars are turned on if the size of the cropping rectangle is smaller than the height and/or width of the image.

Syntax

int set_croprect_scroll(java.awt.Container sf, int xs, int ys, int xe, int ye, int aspect);

Remark

Table 7-69 lists the set_croprect_scroll(java.awt.Container, int, int, int, int, int) method variable descriptions.

Returns

The return value, if positive, is the new zoom value.

_________________________________________________________________________

Example

public void mouseReleased(MouseEvent e)
{
      Point pt,pt2;
      
      if (select)
      {
         snbd_draw_pen();
         pt = new Point();
         pt2 = new Point();
         pt.x = selrect.x;
         pt.y = selrect.y;
         Simage.map_wnd_to_image(this,pt);   
      
         pt2.x = selrect.x + selrect.width;
         pt2.y = selrect.y + selrect.height;
         Simage.map_wnd_to_image(this,pt2);

         if(pt.x > pt2.x)
         {
            selrect.x = pt.x;
            pt.x = pt2.x;
            pt2.x = selrect.x;
         }
         if(pt.y > pt2.y)
         {
            selrect.y = pt.y;
            pt.y = pt2.y;
            pt2.y = selrect.y;
         }
         zoom = Simage.set_croprect_scroll(this, pt.x, pt.y, pt2.x
         pt.x, pt2.y pt.y,1);   
      
         if (zoom <0)   
            zoom = 0;
            cropped = 1;
               select = false;
            selrect = null;
            repaint();
      }

}

_________________________________________________________________________

setFrame(java.awt.Container)

This method sets the destination container for image display.

Syntax

void setFrame(java.awt.Container c);

Remark

Table 7-70 lists the setFrame(java.awt.Container) method variable descriptions.

setXdpi(int)

This method sets the resolution, in dpi (dots per inch, 1/72nd of an inch), along the X-axis of an image. The value is saved in the image.

Syntax

int setXdpi(int dpi);

Returns

Integer. Any positive value (as well as 0) is a valid return.

setYdpi(int)

This method sets the resolution, in dpi (dots per inch, 1/72nd of an inch), along the Y-axis of an image. The value is saved in the image.

Syntax

int setYdpi(int dpi);

Returns

Integer. Any positive value (as well as 0) is a valid return.

Snowbnd(int, int, int)

This is an alternate constructor for the Snowbnd object. This allows the creation of a blank image with allocated memory.

Syntax

Snowbnd(int xsize, int ysize, int bits_pix);

Remark

Table 7-71 lists the Snowbnd(int, int, int) method variable descriptions.

Snowbnd(Snowbnd)

This is an alternate constructor that creates a new Snowbnd object by copying the contents of an existing Snowbnd object.

Syntax

Snowbnd(Snowbnd toCopy);

Remark

Table 7-72 lists the Snowbnd(Snowbnd) method variable description.