V2k Info

<body topmargin=0 leftmargin=0 marginheight=0 marginwidth=0> <table cellpadding=0 cellspacing=0 border=0><tr> <td valign="top" height=95 BGCOLOR="#CC99CC" TEXT="#080000" background="006265f1ezuady.png"> <div> <FONT SIZE="5" COLOR="#000000" FACE="Times New Roman" ><B>Final Fantasy Chronicles News</B></FONT><B>  </B><B> </B><B>|   </B><A HREF="index.htm" TARGET="_top" TITLE="Final Fantasy Chronicles News"><U><B>home</B></U></A></div> <div> <A HREF="id26.htm" TARGET="_top" TITLE="Game Authoring Template"><U>Game Authoring Template</U></A>   |   <A HREF="id27.htm" TARGET="_top" TITLE="Verge Neverending Story"><U>Verge Neverending Story</U></A>   |   <A HREF="id28.htm" TARGET="_top" TITLE="Verge Vs Everything Else"><U>Verge Vs Everything Else</U></A>   |   <A HREF="id29.htm" TARGET="_top" TITLE="Verge Versions"><U>Verge Versions</U></A>   |   <A HREF="id30.htm" TARGET="_top" TITLE="Intro to Verge 2.5"><U>Intro to Verge 2.5</U></A>   |   <A HREF="id20.htm" TARGET="_top" TITLE="Bad Game Design"><U>Bad Game Design</U></A>   |   <A HREF="id21.htm" TARGET="_top" TITLE="Bad Game Design 2"><U>Bad Game Design 2</U></A>   |   <A HREF="id31.htm" TARGET="_top" TITLE="RPG Menus"><U>RPG Menus</U></A>   |   <A HREF="id22.htm" TARGET="_top" TITLE="Medeval Demographics"><U>Medeval Demographics</U></A>   |   <B>V2k Info</B>   |   <A HREF="id23.htm" TARGET="_top" TITLE="Resources for the Verge Community"><U>Resources for the Verge Community</U></A>   |   <A HREF="id24.htm" TARGET="_top" TITLE="RPG Development"><U>RPG Development</U></A>   |   <A HREF="id25.htm" TARGET="_top" TITLE="Map Technical Specs"><U>Map Technical Specs</U></A>   |   <A HREF="id60.htm" TARGET="_top" TITLE="Avoiding Spagetti"><U>Avoiding Spagetti</U></A>   |   <A HREF="id61.htm" TARGET="_top" TITLE="Hicolor or Locolor"><U>Hicolor or Locolor</U></A>   |   <A HREF="id62.htm" TARGET="_top" TITLE="Making Maps to the Verge Pallet"><U>Making Maps to the Verge Pallet</U></A>   |   <A HREF="id68.htm" TARGET="_top" TITLE="Final Fantasy Bouncy Digits"><U>Final Fantasy Bouncy Digits</U></A>   |   <A HREF="id69.htm" TARGET="_top" TITLE="The Laws of Final Fantasy"><U>The Laws of Final Fantasy</U></A>   |   <A HREF="id70.htm" TARGET="_top" TITLE="Final Fantasy Case of the Invisible Pers"><U>Final Fantasy Case of the Invisible Person</U></A>   |   <A HREF="id72.htm" TARGET="_top" TITLE="Grand List of RPG Cliches"><U>Grand List of RPG Cliches</U></A></div> <div> </div> </td> </tr><tr> <td valign="top" height=385 BGCOLOR="#FFFFFF" TEXT="#080000"> <div> <A HREF="id11.htm" TARGET="_top" TITLE="Articles"><U>Articles</U></A>  |    <FONT SIZE="1" COLOR="#0000BF" FACE="Arial" ><A HREF="index.htm" TARGET="_top" TITLE="Final Fantasy Chronicles News"><U> home</U></A></FONT></div> <div> <A HREF="id26.htm" TARGET="_top" TITLE="Game Authoring Template"><U>Game Authoring Template</U></A>   |   <A HREF="id27.htm" TARGET="_top" TITLE="Verge Neverending Story"><U>Verge Neverending Story</U></A>   |   <A HREF="id28.htm" TARGET="_top" TITLE="Verge Vs Everything Else"><U>Verge Vs Everything Else</U></A>   |   <A HREF="id29.htm" TARGET="_top" TITLE="Verge Versions"><U>Verge Versions</U></A>   |   <A HREF="id30.htm" TARGET="_top" TITLE="Intro to Verge 2.5"><U>Intro to Verge 2.5</U></A>   |   <A HREF="id20.htm" TARGET="_top" TITLE="Bad Game Design"><U>Bad Game Design</U></A>   |   <A HREF="id21.htm" TARGET="_top" TITLE="Bad Game Design 2"><U>Bad Game Design 2</U></A>   |   <A HREF="id31.htm" TARGET="_top" TITLE="RPG Menus"><U>RPG Menus</U></A>   |   <A HREF="id22.htm" TARGET="_top" TITLE="Medeval Demographics"><U>Medeval Demographics</U></A>   |   <B>V2k Info</B>   |   <A HREF="id23.htm" TARGET="_top" TITLE="Resources for the Verge Community"><U>Resources for the Verge Community</U></A>   |   <A HREF="id24.htm" TARGET="_top" TITLE="RPG Development"><U>RPG Development</U></A>   |   <A HREF="id25.htm" TARGET="_top" TITLE="Map Technical Specs"><U>Map Technical Specs</U></A>   |   <A HREF="id60.htm" TARGET="_top" TITLE="Avoiding Spagetti"><U>Avoiding Spagetti</U></A>   |   <A HREF="id61.htm" TARGET="_top" TITLE="Hicolor or Locolor"><U>Hicolor or Locolor</U></A>   |   <A HREF="id62.htm" TARGET="_top" TITLE="Making Maps to the Verge Pallet"><U>Making Maps to the Verge Pallet</U></A>   |   <A HREF="id68.htm" TARGET="_top" TITLE="Final Fantasy Bouncy Digits"><U>Final Fantasy Bouncy Digits</U></A>   |   <A HREF="id69.htm" TARGET="_top" TITLE="The Laws of Final Fantasy"><U>The Laws of Final Fantasy</U></A>   |   <A HREF="id70.htm" TARGET="_top" TITLE="Final Fantasy Case of the Invisible Pers"><U>Final Fantasy Case of the Invisible Person</U></A>   |   <A HREF="id72.htm" TARGET="_top" TITLE="Grand List of RPG Cliches"><U>Grand List of RPG Cliches</U></A></div> <div> V2k Info</div> <div> This list is a combination of the VCC FAQ's list of undocumented functions and my own sifting through V2K's readme file. If anyone knows of another source for documentation on new V2K functions and system variables, please tell me. See the V2K readme for other changes.</div> <bR> <div> Note that the documentation for some (mostly graphics functions) is incomplete because I don't have much of a graphics background, and haven't had a chance to experiment with them. If anyone knows what they do or uses for them, please E-Mail me at <FONT SIZE="3" COLOR="#0000FF" FACE="Arial" ><A HREF="mailto:nolip@istar.ca" TARGET="_top" TITLE="mailto:nolip@istar.ca"><U><U>nolip@istar.ca</U></U></A></FONT>.</div> <bR> <div> int FileSize(string filename)</div> <div> This function returns the size of the file specified in bytes. This can be used to stop reading from a file before you reach the end.</div> <bR> <div> int asc(string chr</div> <div> This function returns the ASCII code of the first character in the string.</div> <bR> <div> void FlatPoly(int x1,y1, x2,y2, x3,y3, color);</div> <div> This command is supposed to draw a solid triangle filled with the color of your choice. It has serious bugs however and I actually had to write a replacement in VC. You can find that in my 'speech' script if you look hard enough.</div> <bR> <div> void TMapPoly(int x1,y1, x2,y2, x3,y3, tx1,ty1, tx2,ty2, tx3,ty3, tw,th, image);</div> <div> This function takes an image and splits it into two triangular images (along a diagonal line I assume) which are then drawn using the coordinates you specify. I haven't really used this, more information would be appreciated.</div> <bR> <div> void CallEvent(int event)</div> <div> You can use this function to cause an event in the current map's VC to be executed. Control returns to the point after the call when the event completes.</div> <bR> <div> int NumForScript(Function)</div> <div> This interesting function lets you save the address of a function to an integer variable. This is necessary for the next function. Don't include parentheses or quotes, and remember that you can't pass any arguments to it.</div> <bR> <div> void CallScript(int script)</div> <div> You can pass the result of a NumForScript call to this function to execute the function. You can't pass any arguments, and I don't believe there is any return value either.</div> <bR> <div> void RotScale(int x, y, width, height, angle, scale, image)</div> <div> This is a very useful function. It allows you to display an image at a given position, rotation and scale. As far as I can tell, the coordinates represent where you want the center of the image to be drawn, relative to the screen. For example, you would use ScreenX/2, ScreenY/2 to have the image displayed at approximately the center of the screen.</div> <bR> <div> void TMapLine(int x, int y, int row, int layer)</div> <div> This renders a single row of pixels for the display and you would call it screeny times at different locations to do whatever kind of effect you wanted. You should be able use it to make wave-like effects, etc., but when I tested it I got nothing but page-faults.</div> <bR> <div> void ChangeChr(int index, string chr)</div> <div> This function can change the CHR file displayed by entity 'index'. If that's not useful.. then.. what do I know. (NOTE: Found only in V2.5!)</div> <bR> <div> void QuickRead(string fname, string s, int linenum)</div> <div> This function opens the file 'fname' and returns line 'linenum' of it to the (global?) string 's'. As you are passing the filename as a parameter, you don't need to open and close the file yourself.</div> <bR> <div> void CheckCorrupt(void)</div> <div> This function checks for corruption in V2's allocated memory. When you would want to call this, I'm not sure.</div> <bR> <div> numents (system variable)</div> <div> According to the 2.5 readme file, this returns the number of entities on the map.</div> <bR> <div> mask_color (read-only)</div> <div> Returns the masking value for the current bit depth (if someone could explain this to me, that would be useful!)</div> <div> <I>[editor's note] V2K uses color RGB(255,0,255) for transparent areas. It returns this.</I></div> <bR> <div> void ChangeAll(int source, int width, int length, int source_color, int dest_color)</div> <div> This system function takes the source image (with width and length specified) and changes all colors that match source_color into dest_color. Handy for on-the-fly image manipulation!</div> <bR> <div> void Mask(int source, int mask, int width, int length, int dest);</div> <div> Performs a "simple AND mask" on the given image data, outputting to destination image data. Since I don't know much graphics stuff, it would be useful if someone else could provide more detail on this, such as exactly what an AND mask is, what the mask argument is, and why this would be handy.</div> <bR> <div> entity.visible (system variable)</div> <div> This controls whether or not a given entity is visible. Entities are specified as if it were an array (entity.visible[1] would refer to entity #1). 1 means the entity is visible, 0 means it isn't. Very useful!</div> <bR> <div> entity.on (system variable)</div> <div> Essentially the same as entity.visible, but more so. If this is set to zero for an entity, then as far as the engine is concerned, that entity no longer exists.</div> <bR> <div> int GetR(int packed);</div> <div> int GetG(int packed);</div> <div> int GetB(int packed);</div> <div> These are used to get the Red, Green, and Blue components of a color produced with RGB() that has been assigned to a variable</div> <div> Ex:</div> <bR> <div> int blue = RGB(5, 5, 155);</div> <div> GetR(blue) // == 5</div> <div> GetG(blue) // == 5</div> <div> GetB(blue) // == 155</div> <bR> <div> int RGB(int R, int G, int B);</div> <div> This is used to get color values with the given RGB components in 16 or 15 bit color modes. Simply pass RGB(whatver, yatta, yatta) where you would have previously passed a color index.</div> <bR> <div> entity.isob</div> <div> Controls whether or not a given entity is an obstruction or not.</div> <bR> <div> entity.canob</div> <div> Controls whether or not a given entity can be affected by obstructions.</div> <bR> <div> (Change to starting: Verge no longer starts on a map, and instead starts with the AutoExec function in system.vc)</div> <bR> <div> (As a side-note, for anyone who's reading this who likes object-oriented programming, you can use NumForScript and CallScript in conjunction with arrays to simulate a class with member functions. Should do until someone gets around to trying to write Verge++ ;)</div> <bR> <div> (As another side-note, to use the maped that comes with V2K, type dos4gw maped.exe. This requires you to have a copy of dos4gw and maped in the current directory.)</div> <bR> </td> </tr></table></body>