summaryrefslogtreecommitdiff
path: root/INSTALL
blob: 04f4252c798d702e24dc8d99310c856aaada0454 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
These Milkshape plugins require a DLL that allows the plugin to function
(DON'T get me started on the genius of returning C++ classes from DLLs...)

Details on building this are in step II.

----------------------------------------------------------------------------
I. GETTING STARTED
----------------------------------------------------------------------------

Pre-requisites:

    mingw with msys.

    Microsoft C++ Compiler (I used the free Visual C++ 2003 Toolkit).  This
    is optional.

    w32dlib -- this is a simple Win32 dialog library available from:
    	http://www.wherewilliputthisbloodything?.com/

    Edit make.conf and set the path to your Milkshape SDK as appropriate.
    Also edit the other variables as you see fit.


----------------------------------------------------------------------------
II. BUILDING THE DLL WRAPPER
----------------------------------------------------------------------------

If you wish to build your own wrapper then:

    1. Open a command tool (with paths set to the MS C++ compiler) and cd
       into the wrapper directory.

    2. type 'nmake'.

    3. Copy the resulting mingwms.dll to your Milkshape application directory.


If you wish to use the pre-built wrapper (the DLL and LIB file are part of
the source release for people without the compiler), simply:

    1. Copy the wrapper/mingwms.dll to your Milkshape application directory.


----------------------------------------------------------------------------
III. BUILDING THE TEST DLL
----------------------------------------------------------------------------

You can skip this if your feeling over-confident...

    1. Open an MSYS shell.

    2. cd test

    3. Type make.

    4. Copy the resulting mstest.dll to your Milkshape application directory.

    5. Run Milkshape and test the "Mingw test plugin".  It simply displays
       the names of the meshes in a model using the medium of Message Boxes.


----------------------------------------------------------------------------
IV. BUILDING THE (SIMPLE) OPENGL DLL
----------------------------------------------------------------------------

    1. Open an MSYS shell.

    2. cd opengl

    3. make depend

    3. make

    4. Copy the resulting msGLExport.dll to your Milkshape directory.

    5. Run Milkshape, load a model and you can export using "Simple OpenGL".

    6. Docs for this will are available in docs/msGLExport.txt


----------------------------------------------------------------------------
IV. BUILDING THE EXPLODE MODEL DLL
----------------------------------------------------------------------------

    1. Open an MSYS shell.

    2. cd groupexplode

    3. make depend

    3. make

    4. Copy the resulting msGrpExplode.dll to your Milkshape directory.

    5. Run Milkshape, load a model and you can use the "Group Exploder" tool.

    6. Docs for this will are available in docs/msGrpExplode.txt



----------------------------------------------------------------------------
$Id: INSTALL,v 1.1 2005-05-08 23:44:30 ianc Exp $