1 /*
2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
3 %                                                                             %
4 %                                                                             %
5 %                                                                             %
6 %                            U   U  IIIII  L                                  %
7 %                            U   U    I    L                                  %
8 %                            U   U    I    L                                  %
9 %                            U   U    I    L                                  %
10 %                             UUU   IIIII  LLLLL                              %
11 %                                                                             %
12 %                                                                             %
13 %                          Write X-Motif UIL Table.                           %
14 %                                                                             %
15 %                              Software Design                                %
16 %                                   Cristy                                    %
17 %                                 July 1992                                   %
18 %                                                                             %
19 %                                                                             %
20 %  Copyright 1999-2019 ImageMagick Studio LLC, a non-profit organization      %
21 %  dedicated to making software imaging solutions freely available.           %
22 %                                                                             %
23 %  You may not use this file except in compliance with the License.  You may  %
24 %  obtain a copy of the License at                                            %
25 %                                                                             %
26 %    https://imagemagick.org/script/license.php                               %
27 %                                                                             %
28 %  Unless required by applicable law or agreed to in writing, software        %
29 %  distributed under the License is distributed on an "AS IS" BASIS,          %
30 %  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.   %
31 %  See the License for the specific language governing permissions and        %
32 %  limitations under the License.                                             %
33 %                                                                             %
34 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
35 %
36 %
37 */
38 
39 /*
40   Include declarations.
41 */
42 #include "MagickCore/studio.h"
43 #include "MagickCore/attribute.h"
44 #include "MagickCore/blob.h"
45 #include "MagickCore/blob-private.h"
46 #include "MagickCore/cache.h"
47 #include "MagickCore/color.h"
48 #include "MagickCore/color-private.h"
49 #include "MagickCore/colorspace.h"
50 #include "MagickCore/colorspace-private.h"
51 #include "MagickCore/exception.h"
52 #include "MagickCore/exception-private.h"
53 #include "MagickCore/image-private.h"
54 #include "MagickCore/magick.h"
55 #include "MagickCore/memory_.h"
56 #include "MagickCore/monitor.h"
57 #include "MagickCore/monitor-private.h"
58 #include "MagickCore/pixel-accessor.h"
59 #include "MagickCore/quantum-private.h"
60 #include "MagickCore/static.h"
61 #include "MagickCore/string_.h"
62 #include "MagickCore/module.h"
63 #include "MagickCore/utility.h"
64 
65 /*
66   Forward declarations.
67 */
68 static MagickBooleanType
69   WriteUILImage(const ImageInfo *,Image *,ExceptionInfo *);
70 
71 /*
72 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
73 %                                                                             %
74 %                                                                             %
75 %                                                                             %
76 %   R e g i s t e r U I L I m a g e                                           %
77 %                                                                             %
78 %                                                                             %
79 %                                                                             %
80 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
81 %
82 %  RegisterUILImage() adds attributes for the UIL image format to
83 %  the list of supported formats.  The attributes include the image format
84 %  tag, a method to read and/or write the format, whether the format
85 %  supports the saving of more than one frame to the same file or blob,
86 %  whether the format supports native in-memory I/O, and a brief
87 %  description of the format.
88 %
89 %  The format of the RegisterUILImage method is:
90 %
91 %      size_t RegisterUILImage(void)
92 %
93 */
RegisterUILImage(void)94 ModuleExport size_t RegisterUILImage(void)
95 {
96   MagickInfo
97     *entry;
98 
99   entry=AcquireMagickInfo("UIL","UIL","X-Motif UIL table");
100   entry->encoder=(EncodeImageHandler *) WriteUILImage;
101   entry->flags^=CoderAdjoinFlag;
102   (void) RegisterMagickInfo(entry);
103   return(MagickImageCoderSignature);
104 }
105 
106 /*
107 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
108 %                                                                             %
109 %                                                                             %
110 %                                                                             %
111 %   U n r e g i s t e r U I L I m a g e                                       %
112 %                                                                             %
113 %                                                                             %
114 %                                                                             %
115 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
116 %
117 %  UnregisterUILImage() removes format registrations made by the
118 %  UIL module from the list of supported formats.
119 %
120 %  The format of the UnregisterUILImage method is:
121 %
122 %      UnregisterUILImage(void)
123 %
124 */
UnregisterUILImage(void)125 ModuleExport void UnregisterUILImage(void)
126 {
127   (void) UnregisterMagickInfo("UIL");
128 }
129 
130 /*
131 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
132 %                                                                             %
133 %                                                                             %
134 %                                                                             %
135 %   W r i t e U I L I m a g e                                                 %
136 %                                                                             %
137 %                                                                             %
138 %                                                                             %
139 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
140 %
141 %  Procedure WriteUILImage() writes an image to a file in the X-Motif UIL table
142 %  format.
143 %
144 %  The format of the WriteUILImage method is:
145 %
146 %      MagickBooleanType WriteUILImage(const ImageInfo *image_info,
147 %        Image *image,ExceptionInfo *exception)
148 %
149 %  A description of each parameter follows.
150 %
151 %    o image_info: the image info.
152 %
153 %    o image:  The image.
154 %
155 %    o exception: return any errors or warnings in this structure.
156 %
157 */
WriteUILImage(const ImageInfo * image_info,Image * image,ExceptionInfo * exception)158 static MagickBooleanType WriteUILImage(const ImageInfo *image_info,Image *image,
159   ExceptionInfo *exception)
160 {
161 #define MaxCixels  92
162 
163   char
164     basename[MagickPathExtent],
165     buffer[MagickPathExtent],
166     name[MagickPathExtent],
167     *symbol;
168 
169   int
170     j;
171 
172   MagickBooleanType
173     status,
174     transparent;
175 
176   MagickSizeType
177     number_pixels;
178 
179   PixelInfo
180     pixel;
181 
182   register const Quantum
183     *p;
184 
185   register ssize_t
186     i,
187     x;
188 
189   size_t
190     characters_per_pixel,
191     colors;
192 
193   ssize_t
194     k,
195     y;
196 
197   static const char
198     Cixel[MaxCixels+1] = " .XoO+@#$%&*=-;:>,<1234567890qwertyuipasdfghjk"
199                          "lzxcvbnmMNBVCZASDFGHJKLPIUYTREWQ!~^/()_`'][{}|";
200 
201   /*
202     Open output image file.
203   */
204   assert(image_info != (const ImageInfo *) NULL);
205   assert(image_info->signature == MagickCoreSignature);
206   assert(image != (Image *) NULL);
207   assert(image->signature == MagickCoreSignature);
208   if (image->debug != MagickFalse)
209     (void) LogMagickEvent(TraceEvent,GetMagickModule(),"%s",image->filename);
210   assert(exception != (ExceptionInfo *) NULL);
211   assert(exception->signature == MagickCoreSignature);
212   status=OpenBlob(image_info,image,WriteBinaryBlobMode,exception);
213   if (status == MagickFalse)
214     return(status);
215   (void) TransformImageColorspace(image,sRGBColorspace,exception);
216   transparent=MagickFalse;
217   i=0;
218   p=(const Quantum *) NULL;
219   if (image->storage_class == PseudoClass)
220     colors=image->colors;
221   else
222     {
223       unsigned char
224         *matte_image;
225 
226       /*
227         Convert DirectClass to PseudoClass image.
228       */
229       matte_image=(unsigned char *) NULL;
230       if (image->alpha_trait != UndefinedPixelTrait)
231         {
232           /*
233             Map all the transparent pixels.
234           */
235           number_pixels=(MagickSizeType) image->columns*image->rows;
236           if (number_pixels != ((MagickSizeType) (size_t) number_pixels))
237             ThrowWriterException(ResourceLimitError,"MemoryAllocationFailed");
238           matte_image=(unsigned char *) AcquireQuantumMemory(image->columns,
239             image->rows*sizeof(*matte_image));
240           if (matte_image == (unsigned char *) NULL)
241             ThrowWriterException(ResourceLimitError,"MemoryAllocationFailed");
242           for (y=0; y < (ssize_t) image->rows; y++)
243           {
244             p=GetVirtualPixels(image,0,y,image->columns,1,exception);
245             if (p == (const Quantum *) NULL)
246               break;
247             for (x=0; x < (ssize_t) image->columns; x++)
248             {
249               matte_image[i]=(unsigned char) (GetPixelAlpha(image,p) ==
250                 (Quantum) TransparentAlpha ? 1 : 0);
251               if (matte_image[i] != 0)
252                 transparent=MagickTrue;
253               i++;
254               p+=GetPixelChannels(image);
255             }
256           }
257         }
258       (void) SetImageType(image,PaletteType,exception);
259       colors=image->colors;
260       if (transparent != MagickFalse)
261         {
262           register Quantum
263             *q;
264 
265           i=0;
266           colors++;
267           for (y=0; y < (ssize_t) image->rows; y++)
268           {
269             q=GetAuthenticPixels(image,0,y,image->columns,1,exception);
270             if (q == (Quantum *) NULL)
271               break;
272             for (x=0; x < (ssize_t) image->columns; x++)
273             {
274               if (matte_image[i] != 0)
275                 SetPixelIndex(image,(Quantum) image->colors,q);
276               i++;
277               q+=GetPixelChannels(image);
278             }
279           }
280         }
281       if (matte_image != (unsigned char *) NULL)
282         matte_image=(unsigned char *) RelinquishMagickMemory(matte_image);
283     }
284   /*
285     Compute the character per pixel.
286   */
287   characters_per_pixel=1;
288   for (k=MaxCixels; (ssize_t) colors > k; k*=MaxCixels)
289     characters_per_pixel++;
290   /*
291     UIL header.
292   */
293   symbol=AcquireString("");
294   (void) WriteBlobString(image,"/* UIL */\n");
295   GetPathComponent(image->filename,BasePath,basename);
296   (void) FormatLocaleString(buffer,MagickPathExtent,
297     "value\n  %s_ct : color_table(\n",basename);
298   (void) WriteBlobString(image,buffer);
299   GetPixelInfo(image,&pixel);
300   for (i=0; i < (ssize_t) colors; i++)
301   {
302     /*
303       Define UIL color.
304     */
305     pixel=image->colormap[i];
306     pixel.colorspace=sRGBColorspace;
307     pixel.depth=8;
308     pixel.alpha=(double) OpaqueAlpha;
309     GetColorTuple(&pixel,MagickTrue,name);
310     if (transparent != MagickFalse)
311       if (i == (ssize_t) (colors-1))
312         (void) CopyMagickString(name,"None",MagickPathExtent);
313     /*
314       Write UIL color.
315     */
316     k=i % MaxCixels;
317     symbol[0]=Cixel[k];
318     for (j=1; j < (int) characters_per_pixel; j++)
319     {
320       k=((i-k)/MaxCixels) % MaxCixels;
321       symbol[j]=Cixel[k];
322     }
323     symbol[j]='\0';
324     (void) SubstituteString(&symbol,"'","''");
325     if (LocaleCompare(name,"None") == 0)
326       (void) FormatLocaleString(buffer,MagickPathExtent,
327         "    background color = '%s'",symbol);
328     else
329       (void) FormatLocaleString(buffer,MagickPathExtent,
330         "    color('%s',%s) = '%s'",name,
331         GetPixelInfoIntensity(image,image->colormap+i) <
332         (QuantumRange/2.0) ? "background" : "foreground",symbol);
333     (void) WriteBlobString(image,buffer);
334     (void) FormatLocaleString(buffer,MagickPathExtent,"%s",
335       (i == (ssize_t) (colors-1) ? ");\n" : ",\n"));
336     (void) WriteBlobString(image,buffer);
337   }
338   /*
339     Define UIL pixels.
340   */
341   GetPathComponent(image->filename,BasePath,basename);
342   (void) FormatLocaleString(buffer,MagickPathExtent,
343     "  %s_icon : icon(color_table = %s_ct,\n",basename,basename);
344   (void) WriteBlobString(image,buffer);
345   for (y=0; y < (ssize_t) image->rows; y++)
346   {
347     p=GetVirtualPixels(image,0,y,image->columns,1,exception);
348     if (p == (const Quantum *) NULL)
349       break;
350     (void) WriteBlobString(image,"    \"");
351     for (x=0; x < (ssize_t) image->columns; x++)
352     {
353       k=((ssize_t) GetPixelIndex(image,p) % MaxCixels);
354       symbol[0]=Cixel[k];
355       for (j=1; j < (int) characters_per_pixel; j++)
356       {
357         k=(((int) GetPixelIndex(image,p)-k)/MaxCixels) %
358           MaxCixels;
359         symbol[j]=Cixel[k];
360       }
361       symbol[j]='\0';
362       (void) CopyMagickString(buffer,symbol,MagickPathExtent);
363       (void) WriteBlobString(image,buffer);
364       p+=GetPixelChannels(image);
365     }
366     (void) FormatLocaleString(buffer,MagickPathExtent,"\"%s\n",
367       (y == (ssize_t) (image->rows-1) ? ");" : ","));
368     (void) WriteBlobString(image,buffer);
369     status=SetImageProgress(image,SaveImageTag,(MagickOffsetType) y,
370       image->rows);
371     if (status == MagickFalse)
372       break;
373   }
374   symbol=DestroyString(symbol);
375   (void) CloseBlob(image);
376   return(MagickTrue);
377 }
378