CloudMax: CloudMax moved page Libobj to App:Libobj: Moved to proper namespace

2014-07-07T09:17:09Z

CloudMax moved page Libobj to App:Libobj: Moved to proper namespace

Mzxrules: 1 revision

2014-06-08T23:22:09Z

1 revision

Jason777 at 22:56, 13 May 2012

2012-05-13T22:56:45Z

New page

{{lowercase title}}
{{lowercase title}}
{{ infobox software
| name = libobj
| author = spinout
| operating system = Cross platform
| language = English
| programming language = C
| genre = Library
| license = Open Source
| website = [https://bitbucket.org/ottehr/libobj/ libobj] on bitbucket.
}}
'''libobj''' is a library written by spinout for manipulating wavefront obj data. It can read and write obj files and their material (mtl) files, as well as write output in N64 [[F3DEX2]], and Zelda 64 collision. There is also an experimental viewer bundled with libobj.
==objn64tool==
Originally intended as an example of how to use libobj for obj -> F3DEX2, objn64tool has since grown to a complex converter capable of converting obj not only to F3DEX2 but also to Zelda 64 collision, using functions provided by libobj. It also can produce display lists which are "ready" to have animated materials, outputting a C header and source file defining many aspects of the output. 
 
[https://bitbucket.org/ottehr/libobj/downloads/objn64tool.exe Latest Win32 binary]
===Using objn64tool===
Make sure you know how to use a command line. I even took the time to do long options. 
Usage: <tt>objn64tool.exe [options]</tt> 
 
<table>
<tr><td>Option</td><td>Long option</td><td>Description</td></tr>
<tr><td><tt>-h</tt></td><td><tt>--help</tt></td><td>This help</td></tr>
<tr><td><tt>-v</tt></td><td><tt>--verbose</tt></td><td>Be verbose</td></tr>
<tr><td><tt>-N</tt></td><td><tt>--normalize-all</tt></td><td>Normalize all materials (EXPERIMENTAL)</td></tr>
<tr><td><tt>-n MAT</tt></td><td><tt>--normalize=MAT</tt></td><td>Normalize a specific material (EXPERIMENTAL)</td></tr>
<tr><td><tt>-C FILE</tt></td><td><tt>--consts=FILE</tt></td><td>Write constants to file <tt>FILE</tt> (<tt>-</tt> for stdout)</td></tr>
<tr><td><tt>-H FILE</tt></td><td><tt>--header=FILE</tt></td><td>Write declarations of symbols to <tt>FILE</tt></td></tr>
<tr><td><tt>-i OBJ</tt></td><td><tt>--input=OBJ</tt></td><td>Convert obj file <tt>OBJ</tt></td></tr>
<tr><td><tt>-o FILE</tt></td><td><tt>--output=FILE</tt></td><td>Write to file <tt>FILE</tt></td></tr>
<tr><td><tt>-b ADDR</tt></td><td><tt>--base=ADDR</tt></td><td>Set base address to <tt>ADDR</tt> (ex: <tt>0x06000000</tt>)</td></tr>
<tr><td><tt>-s SCALE</tt></td><td><tt>--scale=SCALE</tt></td><td>Multiply verts by <tt>SCALE</tt> (default <tt>1.0</tt>)</td></tr>
<tr><td><tt>-a MAT</tt></td><td><tt>--scroll=MAT</tt></td><td>Set up material <tt>MAT</tt> to be scrolled (See note)</td></tr>
<tr><td><tt>-c</tt></td><td><tt>--collision</tt></td><td>Generate collision</td></tr>
<tr><td><tt>-M OPT</tt></td><td><tt>--organize=OPT</tt></td><td>See note below</td></tr>
<tr><td><tt>-E NAME</tt></td><td><tt>--collision-exclude=NAME</tt></td><td>See note below</td></tr>
</table> 
Example: 
<tt>  objn64tool.exe -v -C conf.c -b 0x06000000 -s 2.0 -i test.obj -o test.bin</tt> 
Converts object <tt>test.obj</tt> to F3DEX2 binary <tt>test.bin</tt>, scaling it by <tt>2.0</tt>, using base address <tt>0x06000000</tt>, writing a configuration to <tt>conf.c</tt>. 
 
It should be noted that the <tt>-a/--scroll</tt> option does not make a scrolling texture, but instead, it sets a texture offset to a bank greater than 8 and gives texture information to the file specified by the <tt>-C/--consts</tt> option. It is intended to use this option in combination with code which sets up banks which play with texture offests - for example, a texture can be made to scroll left-to-right by increasing it's offset by one pixel at a given interval, since the <tt>-a</tt> option also copies the first row of pixels to an (unused) row of pixels. Again, check out the information the consts file produces when this option is used. 
 
'''About -M (--organize) and -E (--collision-exclude) options''' 
The <tt>-M</tt> option specifies what collision types are sorted by. Valid values are: 
<tt>  material 
  group 
  smoothinggroup 
  object</tt> 
The <tt>-E</tt> option excludes every one of the object's components that can be categorized by the <tt>-M</tt> option and the <tt>-E</tt> argument's option. Take the following options in an example set of options: 
<tt>  -M group -E water_group_00</tt> 
The <tt>-M group</tt> tells that collision is to be generated and sorted by groups, and the <tt>-E water_group_00</tt> tells the converter not to generate collision for the group named <tt>water_group_00</tt>. If the <tt>-E</tt> option is used without the <tt>-M</tt> option, the sorting is assumed to be done by material. 
 
A similar function for excluding and sorting graphics mesh is planned

[[Category:Software]]

← Older revision	Revision as of 09:17, 7 July 2014
(No difference)

← Older revision	Revision as of 23:22, 8 June 2014
(No difference)

App:Libobj - Revision history

CloudMax: CloudMax moved page Libobj to App:Libobj: Moved to proper namespace

Mzxrules: 1 revision

Jason777 at 22:56, 13 May 2012