This wiki is out of date, use the continuation of this wiki instead

From FenixWiki

Revision as of 20:07, 25 February 2008 (edit) 85.144.194.29 (Talk) (Background to something else then.) ← Previous diff		Current revision (20:07, 25 February 2008) (edit) (undo) 85.144.194.29 (Talk) (→Notes - clean --> clear)
Line 20:		Line 20:
	== Notes ==		== Notes ==
-	Instead of using '''map_clear'''() to clean the screen [[background]], [[clear_screen]]() is recommended as it is a little bit faster.	+	Instead of using '''map_clear'''() to clear the screen [[background]], [[clear_screen]]() is recommended as it is a little bit faster.
	== Errors ==		== Errors ==

---

Current revision

Contents 1 Definition 2 Parameters 3 Returns 4 Notes 5 Errors 6 Example

[edit] Definition

INT map_clear ( <INT fileID> , <INT graphID> , <WORD color> )

Clears a certain graph to a certain color.

[edit] Parameters

INT fileID	- The file that holds the graphic.
INT graphID	- The graphic to clear.
WORD color	- The color used to clear.

[edit] Returns

INT : true

[edit] Notes

Instead of using map_clear() to clear the screen background, clear_screen() is recommended as it is a little bit faster.

[edit] Errors

Unsupported color depth

- The specified graph has a not supported color depth.

[edit] Example

Program a_map_is_born;
Private
    int map;
Begin

    // Create a new graph of size 100x100 and color depth of 8bit
    map = new_map(100,100,8);
    
    // Clear the map red
    map_clear(0,map,rgb(255,0,0));

    // Put it in the center of the screen
    put(0,map,160,100);

    Loop
        frame;
    End

End

Used in example: new_map(), put()

This will result in something like:

Maps Functions

• Graphic_info() • Map_block_copy() • Map_clear() • Map_clone() • Map_put() • Map_put_pixel() • Map_xput() • Map_xputnp() • New_map() • Save_png() • Unload_map() •