Quentin Mathé wrote: > Le 28 févr. 08 à 01:12, Fred Kiefer a écrit : >> Quentin Mathé wrote: >>> A last question, why +[NSBezierPath clipRect:] doesn't call NSRectClip >>> in GNUstep NSBezierPath.m? Apple documentation sounds to define them as >>> identical, but I'm not perfectly sure though. >>> >> >> clipRect calls PSrectclip and NSRectClip calls DPSrectclip which are the >> identical function apart from some Macro processing. The only difference >> is that the later also sets a new path, but this already gets done on >> the GSGState level. > > Why not favor only one function like DPSrectclip and keep the other one > only for compatibility reason? This part of the API could be a bit more > clear imo. For example, no documentation is available on the following > pages: > - > http://www.gnustep.org/resources/documentation/Developer/Gui/Reference/index.html > > - > http://www.gnustep.org/resources/documentation/Developer/Gui/Additions/index.html > (only > CG functions seems to be provided when you read the doc). > By publishing those functions and their related classes on the last > page, we may know better which parts of the API can be used safely in > the drawing code of applications. >
I am not sure, whether I understand this question correctly. Are you asking why the PS and DPS methods are not documented? To be honest, I just don't know. I only know why I myself would not document them, but this is of course not stopping you from doing so. To my all these Display Postscript functions are a left over from the old Next specification. We will keep them in GNUstep ans support them as much as possible, but for new development I would advice to use the higher level that the AppKit classes provide. So if you ask me whether we should prefer PSrectclip or DPSrectclip, I would say none of them use [NSBezierPath clipRect:] instead. Using NSRectClip is fine as well, though. It would be great if Camaelon could be implemented without the use of DPS functions. Not sure, whether this is already possible with current GNUstep code. Cheers, Fred _______________________________________________ Etoile-discuss mailing list [email protected] https://mail.gna.org/listinfo/etoile-discuss
