topic Re: Changing the Library folder in ARCHICAD12 in Archicad C++ API

Changing the Library folder in ARCHICAD12

Anonymous — Mon, 09 Sep 2024 08:54:13 GMT

Hi,

I want to change my project Libraries Folder in ArchiCAD 12.
I am using following function.

Void setupLibrariesForAC12()
{
API_LibrariesInfo libInfo;

memset(&libInfo, 0, sizeof(API_LibrariesInfo));
libInfo.nLib = 2;
libInfo.locations = (IO::Location**) BMAllocateHandle (libInfo.nLib * sizeof(IO::Location, ALLOCATE_CLEAR, 0);
libInfo.useSatellite = false;

new (*libInfo.locations) IO::Location (“C:\\Archicad12\\Archicad Library”);
new (*libInfo.locations + 1) IO::Location (“C:\\Archicad Development Library”);

ACAPI_Environment(APIEnv_SetLibrariesID, &libInfo, NULL);
(*libInfo.locations).~Location();
(*libInfo.locations + 1).~Location();

BMKillHandle(reinterpret_cast<GSHandle *> (&libInfo.locations));
}

But I am getting following errors
err LNK2001:unresolved external symbol “public: virtual class GS::ClassInfo * __thiscall GS::Object::GetClassInfoA(void)const “(?getClassInfoA@object@GS@@UBEPAVClassInfo@2@XZ)
fatal error LNK1120: 1 unresolved externals.

Please help me to solve these errors.

Re: Changing the Library folder in ARCHICAD12

Ralph Wessel — Wed, 04 Feb 2009 15:01:25 GMT

Ranga wrote:
I want to change my project Libraries Folder in ArchiCAD 12.
I am using following function.
Void setupLibrariesForAC12()
...etc...
Please help me to solve these errors.

Does the problem go away if you write it like this (i.e. changing just part of your function)?


libInfo.locations = (IO::Location**) BMAllocateHandle (libInfo.nLib * sizeof(IO::Location, ALLOCATE_CLEAR, 0); 
libInfo.useSatellite = false; 

(*libInfo.locations)[0] = IO::Location(“C:\\Archicad12\\Archicad Library”);
(*libInfo.locations)[1] = IO::Location(“C:\\Archicad Development Library”);

ACAPI_Environment(APIEnv_SetLibrariesID, &libInfo, NULL); 

BMKillHandle(reinterpret_cast<GSHandle *> (&libInfo.locations));

Re: Changing the Library folder in ARCHICAD12

Oleg — Wed, 04 Feb 2009 15:19:34 GMT

Hi,

Have you GSRootImp.LIB in your project ?

Re: Changing the Library folder in ARCHICAD12

Anonymous — Wed, 04 Feb 2009 20:13:04 GMT

Oleg wrote:
Hi,

Have you GSRootImp.LIB in your project ?

Oleg,

What a good surprise to read you. It's a long time. I hope you are fine.
Your GDL and API programmer expertise is missing.

Kliment recently pointed out your "rxDuplicator" Add-On (AC8 & 9), among other jewels.
Years after, the similar tool on AC12, is a bit poor, in comparison.

May we expect from you a come back on AC-Talk?

Cheers,
Olivier

Re: Changing the Library folder in ARCHICAD12

Anonymous — Thu, 05 Feb 2009 00:26:13 GMT

Hi Ralph Wessel,

It is working fine if i use
(*libInfo.locations)[0] = IO::Location("C:\\ArchiCAD 12\\ Archicad Library 12");

but in the run time it is failing
at line
(*libInfo.locations)[0].~Location();

i can't use the try and catch because it is saying "error C2712: Cannot use __try in functions that require object unwinding"

i don't know what to do. can you please help me ranga

Re: Changing the Library folder in ARCHICAD12

Oleg — Thu, 05 Feb 2009 04:54:04 GMT

Olivier wrote:

What a good surprise to read you. It's a long time. I hope you are fine.

Olivier

Hi Olivier and all, thanks for warm words. I am fine.
I occasionally read the Talk, but I have no time to participate absolutely.
( Also has almost forgotten English language in addition. )
Good luck. I should disappear again.

PS: Ranga, I am sorry for personal messages in your thread.

Oleg

Re: Changing the Library folder in ARCHICAD12

Oleg — Thu, 05 Feb 2009 06:35:43 GMT

Hi Ranga,

(I am sorry my English)

I am not sure in following, just guessing.

Actually, it seems is a right way:
new (*libInfo.locations) IO::Location ("C:\\Archicad12\\Archicad Library");
new (*libInfo.locations + 1) IO::Location ("C:\\Archicad Development Library");

and then

(*libInfo.locations)->~Location();
(*libInfo.locations + 1)->~Location();

But looking at Location header (Location class), there is :
#if defined (DEBUVERS)
Int32* leakDetector;
#endif

So, sizeof of Location class is different in Debug and Release build.
And I think none of attemts will not work in Debug mode.

Try your code in Release mode. It may works.
I think only GS may explain this.
May be there is a way #undef DEBUVERS in your cpp source before #includes, but not sure.

Oleg

Re: Changing the Library folder in ARCHICAD12

Ralph Wessel — Thu, 05 Feb 2009 09:36:54 GMT

Ranga wrote:
Hi Ralph Wessel,

It is working fine if i use
(*libInfo.locations)[0] = IO::Location("C:\\ArchiCAD 12\\ Archicad Library 12");

but in the run time it is failing
at line
(*libInfo.locations)[0].~Location();

That line is directly calling the object's destructor. In the GS example, this is used because they have used placement new in order to directly call the object's constructor and specify where the object is to be allocated. If you take out the placement new (which was my suggestion) you no longer need to call the destructor - it will fail if you do (which is what you are seeing). Either use the code exactly as I stated or use the GS example, but don't mix them.

I would like someone from GS to comment on this, because I don't see an obvious reason for using placement new to allocate the object. Anyone?

Re: Changing the Library folder in ARCHICAD12

Oleg — Thu, 05 Feb 2009 09:53:30 GMT

Hi Ralph,

I agree, GS should comment all of this.

My idea about destructor.

I think it is correct:

(*libInfo.locations)[0] = IO::Location("C:\\ArchiCAD 12\\ Archicad Library 12");

I guess, placement new used only to avoid copy. Just to optimize.
But I think, destructor needs anyway to avoid memory leak at kill handle.
(*libInfo.locations)[0].~Location();

And It is possible that will work for first member of array.
But I think if DEBUVERS is defined then next items of array like
(*libInfo.locations)[1] = IO::Location("C:\\ArchiCAD 12\\ Archicad Library 12");
will not work as copied at wrong place. But really it is correct, you are right.

Intresting stuff. But have no time to test.

Oleg

Re: Changing the Library folder in ARCHICAD12

Ralph Wessel — Thu, 05 Feb 2009 10:02:46 GMT

Oleg wrote:
I guess, placement new used only to avoid copy. Just to optimize.
But I think, destructor needs anyway to avoid memory leak at kill handle.
(*libInfo.locations)[0].~Location();

The destructor call is only necessary if you have allocated the object with placement new. No memory will be leaked because it is has been allocated (and released) as a handle.

There seems no reason to use placement new for allocation in this case. Yes, it is an 'optimisation', but completely pointless because this call would never be used in a context where optimal performance could make an appreciable difference.

Optimising where there is no benefit, especially where is the code becomes less readable or balancing calls like 'new' and 'delete' are necessary, is both wasteful and risky. I would like to know if there is some other reason why the GS example does this.

Re: Changing the Library folder in ARCHICAD12

Oleg — Thu, 05 Feb 2009 10:26:33 GMT

The Location class may allocate some heap memory internally.
Destructor call is necessary to release it by Location.
I dont think the placement new is the reason.
A handle is not typed array, like std::vecor or C++ array and destructor will not called automatically.

Oleg

Re: Changing the Library folder in ARCHICAD12

Ralph Wessel — Thu, 05 Feb 2009 10:28:24 GMT

Ranga wrote:
I want to change my project Libraries Folder in ArchiCAD 12. I am using following function.
Void setupLibrariesForAC12()
{ etc...

Just for clarity, this function could be:

void setupLibrariesForAC12()
{ 
	API_LibrariesInfo libInfo; 
	
	memset(&libInfo, 0, sizeof(API_LibrariesInfo)); 
	libInfo.nLib = 2; 
	libInfo.locations = (IO::Location**) BMAllocateHandle (libInfo.nLib * sizeof(IO::Location, ALLOCATE_CLEAR, 0)); 
	libInfo.useSatellite = false; 
	
	(*libInfo.locations)[0] = IO::Location(“C:\\Archicad12\\Archicad Library”); 
	(*libInfo.locations)[1] = IO::Location(“C:\\Archicad Development Library”); 
	
	ACAPI_Environment(APIEnv_SetLibrariesID, &libInfo, NULL); 
	
	BMKillHandle(reinterpret_cast<GSHandle *> (&libInfo.locations)); 
}

Could someone from GS comment on whether the calls to placement new and the Location destructor are necessary for some internal initialisation or cleanup?

Ranga, are you sure the link error is connected to this function, i.e. did it link properly previously? And have you linked to the correct libraries as Oleg suggested?

Re: Changing the Library folder in ARCHICAD12

Ralph Wessel — Thu, 05 Feb 2009 10:31:02 GMT

Oleg wrote:
The Location class may allocate some heap memory internally.
Destructor call is necessary to release it by Location.
I dont think the placement new is the reason.
A handle is not typed array, like std::vecor or C++ array and destructor will not called automatically.

Yes, the Location object may have allocated resources... or may do so in future - perhaps it's also a safeguard against future changes?

Re: Changing the Library folder in ARCHICAD12

Oleg — Thu, 05 Feb 2009 10:41:12 GMT

Ralph wrote:
Yes, the Location object may have allocated resources... or may do so in future - perhaps it's also a safeguard against future changes?

Yes, it may have as dynamically length of string path.
But may it is just POD members so your right and desrtuctor is not necessary.

Better if GS do special function like
KillLocationHandle as there is for Prams etc.

But more clear design if there will not mix C++ and C (as most struct is plain structs).
Lets Location returns raw data state and has constructor from state.
Location loc("tt");
LocationState s = loc.GetState();
Lovation l2(s);

And Handle will be og LocationState.

Or move to C++ and break untyped Handles.

But I agree with Ralph, this puzzled direct destructor call is strange.

Re: Changing the Library folder in ARCHICAD12

Ralph Wessel — Thu, 05 Feb 2009 10:54:37 GMT

Oleg wrote:
Better if GS do special function like
KillLocationHandle as there is for Prams etc.
But more clear design if there will not mix C++ and C (as most struct is plain structs).

I agree - this is messy. I guess AC (like most mature software) has to get by with some awkward scenarios as the new is built onto the old. I've sent an email asking for clarification on this one.

Thinking about it, you are probably right. The Location object might either allocate resources or rely on reference counting to release resources when no object refers to them. Either way, explicitly releasing the object would be essential.

Re: Changing the Library folder in ARCHICAD12

Akos Somorjai — Thu, 05 Feb 2009 15:39:58 GMT

Ralph wrote:
I agree - this is messy. I guess AC (like most mature software) has to get by with some awkward scenarios as the new is built onto the old. I've sent an email asking for clarification on this one.

Thinking about it, you are probably right. The Location object might either allocate resources or rely on reference counting to release resources when no object refers to them. Either way, explicitly releasing the object would be essential.

Yep, it does contain a few pointers, which have to be allocated correctly with a constructor call, and also does registration and un-registration as well.
So, all in all, as Oleg said, the BM... routines didn't handle C++ classes correctly, so in some version of the API we have to get rid of them, and use C++-safe containers like GS::Array<>.
In this special case the placement new and the placement delete are required because we store the instance of the C++ class in the non-typed handle, which of course doesn't call the destructor and the constructor.

Re: Changing the Library folder in ARCHICAD12

Anonymous — Fri, 06 Feb 2009 01:51:36 GMT

Ralph wrote:
Ranga wrote:
I want to change my project Libraries Folder in ArchiCAD 12. I am using following function.
Void setupLibrariesForAC12()
{ etc...
Just for clarity, this function could be:
void setupLibrariesForAC12()
{ 
	API_LibrariesInfo libInfo; 
	
	memset(&libInfo, 0, sizeof(API_LibrariesInfo)); 
	libInfo.nLib = 2; 
	libInfo.locations = (IO::Location**) BMAllocateHandle (libInfo.nLib * sizeof(IO::Location, ALLOCATE_CLEAR, 0)); 
	libInfo.useSatellite = false; 
	
	(*libInfo.locations)[0] = IO::Location(“C:\\Archicad12\\Archicad Library”); 
	(*libInfo.locations)[1] = IO::Location(“C:\\Archicad Development Library”); 
	
	ACAPI_Environment(APIEnv_SetLibrariesID, &libInfo, NULL); 
	
	BMKillHandle(reinterpret_cast<GSHandle *> (&libInfo.locations)); 
} 
Could someone from GS comment on whether the calls to placement new and the Location destructor are necessary for some internal initialisation or cleanup?

Ranga, are you sure the link error is connected to this function, i.e. did it link properly previously? And have you linked to the correct libraries as Oleg suggested?

hi Ralph,

If I am using destructor I am getting Link error and If I am not using destructor No errors and and my code working fine(it setting new library).

Ranga

Re: Changing the Library folder in ARCHICAD12

Ralph Wessel — Sat, 07 Feb 2009 15:22:35 GMT

Ranga wrote:
If I am using destructor I am getting Link error and If I am not using destructor No errors and and my code working fine(it setting new library).

Based on the comments from Ákos, you really do need to use placement new and the destructor. Although the amount of memory leaked will probably be quite small, it's poor practice and might bite you later.

I've compiled and linked a project using this function without problems, so I think your project is missing a library. I'm not sure which one is required in this case - I'm linking against the following in XCode:

VBUtils.framework
VBAttributes.framework
UC.framework
TextEngine.framework
ProjectFile.framework
PixMapIO.framework
ObjectDatabase.framework
ModelerGraphics.framework
libACAP_STAT.a
JACK.framework
InputOutput.framework
GX.framework
GSZLib.framework
GSXMLUtils.framework
GSXML.framework
GSUtils.framework
GSRoot.framework
GSQuickTime.framework
GSModeler.framework
Geometry.framework
GDL.framework
DG.framework
AttributeManager.framework

Re: Changing the Library folder in ARCHICAD12

Anonymous — Sun, 12 Apr 2009 17:46:41 GMT

Hi!
I've the same linker error:
error LNK2001: unresolved external symbol "public: virtual class GS::ClassInfo * __thiscall GS::Object::GetClassInfoW(void)const " (?GetClassInfoW@Object@GS@@UBEPAVClassInfo@2@XZ)
after that as added following code
GS::Array<GS::ArrayFB<GS::UniString, 3>> autotexts;
This is a peace of sample from API Development Kit help
The "APIAny_GetAutoTextsID" topic
Example:
#include "UniString.hpp"
#include "Array.hpp"

GS::Array<GS::ArrayFB<GS::UniString, 3> > autotexts;
API_AutotextType type = APIAutoText_Fixed;

GSErrCode err = ACAPI_Goodies (APIAny_GetAutoTextsID, &autotexts, (void *) (long) type);
if (err == NoError) {
for (ULong i = 0; i < autotexts.GetSize (); i++) {
DBPrintf ("AutoText[%03d] \"%s\" (\"%s\") = \"%s\"\n", i,
(const char *) autotexts[0].ToCStr (), (const char *) autotexts[1].ToCStr (), (const char *) autotexts[2].ToCStr ());
}
}

Here is list of my libs:

acap_stat.lib
libcmtd.lib
LIBCPMTD.LIB
kernel32.lib
advapi32.lib
user32.lib
GSRootImp.lib
dgimp.lib
InputOutputImp.lib
libxml2.lib
iconv.lib

I tried include others libs that have GetClassInfo symbol, but it did not help.
Hope to your help!

Thanks in advance,
AT

Re: Changing the Library folder in ARCHICAD12

Anonymous — Tue, 14 Apr 2009 03:24:12 GMT

Hi Apis Terrestris,

May be try this way, it may works.

API_librariesInfo libInfo;
OSErr err;

memset(&libInfo, 0, sizeof(API_librariesInfo));
err = ACAPI_Environment(API_Env_GetLibrariedId, &libInfo, NULL);
if(err == noErr)
{
for(int ii = 0; ii < libInfo.nLib; ++ii)
{
DBPrintf ("AutoText[%03d] = \"%s\"\n", i, GetCPathFromLocation(&(*libInfo.locations)[ii]));
}
}

char * GetCpathFromLocation(IO::Location* location)
{
static char static_path[MAX_Path];
IO::Path path;

if(location->ToPath(&path) == noErr)
strcpy(static_path, path);
else
static_path[0] = ‘\0’;
return static_path;
}

I will try differently with example ‘APIAny_GetAutoTextsID’ and if it works for me I will get back to you.