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

From FenixWiki

Revision as of 15:13, 22 April 2007 (edit) Woody (Talk | contribs) ← Previous diff		Current revision (16:05, 25 February 2008) (edit) (undo) 85.144.194.29 (Talk) (Spelling mistake.)
(7 intermediate revisions not shown.)
Line 3:		Line 3:
	==Definition==		==Definition==
		+	'''INT''' save_png ( <'''INT''' fileID> , <'''INT''' graphID> , <'''STRING''' filename> )
-	'''INT''' save_png ( <'''INT''' file> , <'''INT''' graph> , <'''STRING''' path> )	+	Saves an in-game [[graphic]] as a [[PNG]] file somewhere.
-		+
-	Saves an in-game graphic as a PNG file somewhere.	+
-		+
	== Parameters ==		== Parameters ==
-
	{|		{|
-	| '''INT''' file || - The FPG your graphic is in, or 0 if it isn't in one.	+	| '''INT''' fileID || - The [[fileID]] of the [[file]] that holds the graphic.
	|-		|-
-	| '''INT''' graph || - The graphic to save.	+	| '''INT''' graphID || - The [[graphID]] of the graphic to save.
	|-		|-
-	| '''STRING''' path || - Where on the hard drive to save it as a relative file path.	+	| '''STRING''' filename || - The name of the [[PNG]] file to be saved, including a possible [[path]].
	|}		|}
-
	== Returns ==		== Returns ==
-		+	'''INT''' : Successrate
-	'''INT''' : Returns [[true|1]] if successful and [[false|0]] if failed.	+	{|
-		+	| [[false]] || - Error.
		+	|-
		+	| [[true]] || - Success.
		+	|}
	== Example ==		== Example ==
-
	<pre>		<pre>
	//here's a cool thing to save a screenshot		//here's a cool thing to save a screenshot
Line 41:		Line 39:
	takingscreenshot=1;		takingscreenshot=1;
	graph=get_screen(); // grabs the screen and sets it as the program graphic		graph=get_screen(); // grabs the screen and sets it as the program graphic
-	save_png(0,graph,"shot"+rand(0,9999)+".png"); // saves the graphic as a png with a random number in the filename to prevent overwriting	+	save_png(0,graph,"shot"+rand(0,9999)+".png"); // saves the graphic as a png with a
		+	// random number in the filename to
		+	// prevent overwriting
	unload_map(0,graph); //frees the graphic		unload_map(0,graph); //frees the graphic
	Else		Else
	takingscreenshot=0;		takingscreenshot=0;
	End		End
-	End	+	While(key(_f12)) Frame; End
		+	End
	frame;		frame;
Line 52:		Line 53:
	End		End
	</pre>		</pre>
		+	Used in example: [[key]](), [[get_screen]](), [[unload_map]]()
		+
		+	{{Funcbox
		+	| category = Maps
		+	}}

---

Current revision

Contents 1 Definition 2 Parameters 3 Returns 4 Example

[edit] Definition

INT save_png ( <INT fileID> , <INT graphID> , <STRING filename> )

Saves an in-game graphic as a PNG file somewhere.

[edit] Parameters

INT fileID	- The fileID of the file that holds the graphic.
INT graphID	- The graphID of the graphic to save.
STRING filename	- The name of the PNG file to be saved, including a possible path.

[edit] Returns

INT : Successrate

false	- Error.
true	- Success.

[edit] Example

//here's a cool thing to save a screenshot
Program save_those_pngs;
Global
    takingscreenshot;

Begin

    Loop
        
        If (key(_f12)) 
            If (takingscreenshot==0)
                takingscreenshot=1;
                graph=get_screen(); // grabs the screen and sets it as the program graphic
                save_png(0,graph,"shot"+rand(0,9999)+".png"); // saves the graphic as a png with a
                                                              // random number in the filename to
                                                              // prevent overwriting 
                unload_map(0,graph);  //frees the graphic
            Else
                takingscreenshot=0;
            End
            While(key(_f12)) Frame; End
       End

        frame;
    End
End

Used in example: key(), get_screen(), unload_map()

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() •