Official LDCad shadow library github repository

[Roland Melkert]

The official LDCad shadow library is up and running at:
https://github.com/RolandMelkert/LDCadShadowLibrary

Its initial commit is based on the 1.7 Alpha 2a csl file.

It just has different headers and uses the CC BY-SA 4.0 license.

I used svn commit data and existing AUTHOR lines to populate the initial !HISTORY section of each file.

The 'official' header format is like so:

Code:

0 LDCad shadow info for "<sameDescriptionAsOriginalLDrawFile>"

0 Author: LDCad Shadow Library
0 !LICENSE CC BY-SA 4.0, see LICENSE.md

0 !HISTORY YYY-MM-DD {fullAuthorName} Initial info for <partRefName>
0 !HISTORY YYY-MM-DD {fullAuthorName} <shortChangeDescription>

<LDCad meta content>

The 2nd and later !HISTORY lines should only be appended if needed.

Please use the same format when doing a pull request.


Reason for the general Author:
I wanted to make attribution simpler by letting people attribute the project (permitted by CC BY-SA 4.0 as far I understand it)

Reason for the {name} history lines:
The library is separate from LDraw so using LDraw.org user names might be confusing.

Reason for mentioning the partRefName in a HISTORY line instead of a NAME one:
I now and then move content around while following "move to" changes or to take advantage of new subfiles etc.
Such changes should be noted using something like:

Code:

0 !HISTORY YYY-MM-DD {fullAuthorName} Moved content to <partRefName>

Not sure how to make github track such file renames yet as I usually just copy paste .dat content during shadow editing inside LDCad (it automatically deleted empty shadow files). (EDIT: did some research, git might actually do that automatically if the content of the old and new file are very similar. I guess we'll know when it actually happens )



There are still some other things to sort out / improve upon but I wanted to just get it started 

There will be some tools for editing/creating repo ready shadow files in 1.7 Beta 1.

[Gerald Lasser]

I downloaded the shadow lib from GITHub, and copied it under the "offLibShadow.csl" name there, renaming the old one.

Now when I start LDCad it tells me "Unable to open File, Error 5, Access Denied" although windows permissions look the same on the new and old file.

any clue? Thanks

[Roland Melkert]

I downloaded the shadow lib from GITHub, and copied it under the "offLibShadow.csl" name there, renaming the old one.

Now when I start LDCad it tells me "Unable to open File, Error 5, Access Denied" although windows permissions look the same on the new and old file.

Sounds like a os problem to me, are you sure it has the right properties.

Because even if you just renamed the git 'code' zip you shouldn't get this error. It would just ignore the whole thing as the csl is expected to hold parts an p in its root folder.

It might be easier to use it uncompressed for now.

Or use the csl generation script (linux):
https://github.com/RolandMelkert/LDCadSh.../genCsl.sh