• A5_DESIGN_BITMAP Function
• A5_GET_BITMAP Function
• A5_GET_BMP_FROM_FILE Function
• A5_GET_JPEG Function
• A5_IMAGE_TRANSFORM Function
• a5_ink_to_png Function
• BITMAP Function
• BITMAP_ALPHA Function
• BITMAP_COLORS_GET Function
• BITMAP_HEIGHT Function
• BITMAP_SATURATION Function
• BITMAP_SIZE Function
• Bitmap_to_JPEG Function
• BITMAP_TO_PALETTE_PNG Function
• BITMAP_TO_PNG Function
• BITMAP_TRANSLUCENT Function
• BITMAP_WIDTH Function
• CHANGE_COLOR Function
• CLIP_SHAPE Function
• Displaying and Printing Bitmaps
• DRAW_BOX Function
• DRAW_WRAP_SCRIPT Function
• DRAW_WRAP_TEXT Function
• EXTENT_HEIGHT Function
• EXTENT_WIDTH Function
• FILL_OVAL Function
• FILL_PIE Function
• FILL_POLY Function
• FILL_RECT Function
• FILL_ROUND_RECT Function
• FILL_SHAPE Function
• INNER_OVAL Function
• INNER_PIE Function
• INNER_POLY Function
• INNER_RECT Function
• INNER_ROUND_RECT Function
• INNER_SHAPE Function
• JPEG_TO_BITMAP Function
• LINE Function
• LINETO Function
• OVAL Function
• PIE Function
• PNG_TO_BITMAP Function
• POLY Function
• POLY_BEZIER Function
• RECT Function
• ROUND_RECT Function
• SET_FONT Function
• SET_ORIGIN Function
• SET_ROTATE Function
• SET_SCALE Function
• SET_UNITS Function
• SHAPE Function
• START_POLY Function
• TEXT Function
• TEXT_HEIGHT Function
• TEXT_WIDTH Function
• UI_BITMAP_CREATE Function
• UI_BITMAP_CREATE_FROM_SCREEN Function
• UI_BITMAP_CREATE_FROM_XPM Function
• UI_BITMAP_DRAW Function
• UI_BITMAP_DROP Function
• UI_BITMAP_INFO_GET Function
• UI_BITMAP_LOAD Function
• UI_BITMAP_PNG_LOAD Function
• UI_BITMAP_PNG_SAVE Function
• UI_BITMAP_SAVE Function
• UI_PRINTER_DRAW Function
• UI_SCREEN_DRAW Function
• UI_SHAPE_DESTROY Function
• UI_SHAPE_LINETO Function
• UI_SHAPE_OVAL Function
• UI_SHAPE_POLY Function
• UI_SHAPE_RECT Function
• UI_SHAPE_ROUND_RECT Function
• UI_SHAPE_START_POLY Function
• WINDOW_TO_IMAGE Function
• WRAP_TEXT_HEIGHT Function

CHANGE_COLOR Function

Syntax

Arguments

XPos

The horizontal coordinate of the upper left corner of the rectangular area to be modified.

YPos

The vertical coordinate of the upper left corner of the rectangular area to be modified.

Width

The width of the rectangular area to be modified.

Height

The height of the rectangular area to be modified.

search_colors

The colors to search for.

replace_colors

The colors to substitute.

nomatch_color

Optional.

Description

The CHANGE_COLOR() function changes the colors of pixels in a specified area.

Example

The blue halo around the red letters below is because the font engine smooths (anti-aliases) between the original blue fill color and the white background, resulting in a variety of other blue colors that are not being replaced.

ui_bitmap_create("test", 4, 1)
ui_bitmap_draw("test",<<%code%
set_font("Verdana,20,biu", "blue", "white")
inner_Rect(0, 0, 4, 1)
text("Sample", bitmap_width("test")/2, bitmap_height("test")/2, "center")
change_color(0,0,2,1,"blue","red")
%code%)
ui_dlg_box("","{image=test}")

The next example changes three search colors to three replace colors.

ui_bitmap_draw("test",<<%code%
inner_Rect(0, 0, 4, 2)
set_pen("white")
set_brush("cyan")
fill_rect(0, 0, 1.33, 2)
set_brush("Dark Cyan")
fill_rect(1.34, 0, 1.33, 2)
set_brush("Blue")
fill_rect(2.68, 0, 1.33, 2)
fromcolor = <<%str%
Cyan
Dark Cyan
Blue
%str%
tocolor = <<%str%
Gray-25
Gray-40
Black
%str%
change_color(0, 1, 4, 1, fromcolor, tocolor)
%code%)
ui_dlg_box("","{image=test}")

Limitations

Used only in the Code sections of UI_BITMAP_DRAW(), UI_SCREEN_DRAW(), and UI_PRINTER_DRAW().

See Also

• Bitmap and Graphic Functions