══════════════════

Introduction

══════════════════

This is a Daz Studio script "front end" , a 'User Interface'

for the Windows/DOS application mcjObjGroupByProximity.exe found here: mcjobjgroupbyproximity.exe

Using this, you don't have to learn how to write a DOS command-line / batch file

you simply select the files you want to process and click the run button

══════════════════

History

══════════════════

November 22nd 2014 7:30 pm - Release

══════════════════

Installation

══════════════════

The zip package is found at the bottom of this page

unzip it in your daz content folder, typically

C:\Program Files\DAZ\Studio\content\

or

C:\Program Files (x86)\DAZ\Studio\content\

once installed, it will appear in your content library, under Studio / Scripts / mcasual

or

C:\Users\Public\Documents\My DAZ 3D Library\

once installed, it will appear in your content library, under My DAZ 3D Library / Scripts / mcasual

══════════════════

Use

══════════════════

The 'reference obj' is typically the .obj of a valid Poser-compatible figure.

If this .obj file was rather created by exporting it from Daz Studio, it must be

scaled the same way your 'source obj' is scaled, i.e. 'poser units, 1 unit = 8 ft'

Note: this .obj file is usually copyrighted and should not be redistributed.

The 'source obj' is typically a new clothing item meant to be worn by the reference.

mcjObjGroupByProximity.exe will group each facet of this .obj according to the

proximity of that facet to the groups in the 'reference obj'.

The 'output obj' is the result of that process, which will be written to disk

So you must specify a folder/location for which you have write-privileges

for example: C:\Users\YOURUSERNAME\Documents

Note that mcjObjGroupByProximity.exe will refuse to over-write files

so if you want to re-use a given obj filename, you have to delete or move the

previous version

For all of this to work, of course, you need to download mcjObjGroupByProximity.exe

and install it somewhere on your PC's disks. Then use the 'browse...' button

in the section titled 'Location of the application mcjObjGroupByProximity.exe'

Use the Run button to launch mcjObjGroupByProximity.exe

If you use the 'Create .bat only' button, mcjObjGroupByProximity.exewill not be launched,

instead, a batch file (.bat) will be created in the same folder as your 'Output obj'

Later on you can run this batch file by double-left-clicking on it

this in turn will launch mcjObjGroupByProximity.exe

══════════════════

License

══════════════════

November 22nd 2014

Copyright (c) <mCasual/Jacques>

Permission is hereby granted, free of charge, to any persoration

obtaining a copy of this software and associated documentation

files (the "Software"), to deal in the Software without

restriction, including without limitation the rights to use,

copy, modify, merge, publish, distribute, sublicense, and/or sell

copies of the Software, and to permit persons to whom the

Software is furnished to do so, subject to the following

conditions:

The above copyright notice and this permission notice shall be

included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,

EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES

OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND

NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT

HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,

WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING

FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR

OTHER DEALINGS IN THE SOFTWARE.