modules/midp-lcdui/src/main/java/cc/squirreljme/runtime/lcdui/gfx/ProxyGraphics.java

   1 // -*- Mode: Java; indent-tabs-mode: t; tab-width: 4 -*-
   2 // ---------------------------------------------------------------------------
   3 // SquirrelJME
   4 //     Copyright (C) Stephanie Gawroriski <xer@multiphasicapps.net>
   5 // ---------------------------------------------------------------------------
   6 // SquirrelJME is under the GNU General Public License v3+, or later.
   7 // See license.mkd for licensing and copyright information.
   8 // ---------------------------------------------------------------------------
   9
  10 package cc.squirreljme.runtime.lcdui.gfx;
  11
  12 import cc.squirreljme.runtime.cldc.debug.Debugging;
  13 import javax.microedition.lcdui.Font;
  14 import javax.microedition.lcdui.Graphics;
  15 import javax.microedition.lcdui.Image;
  16 import javax.microedition.lcdui.Text;
  17
  18 /**
  19  * This is a proxy version of {@link Graphics} where each instance can
  20  * refer to a single graphics instance. When a draw operation occurs, the
  21  * parameters of this current graphics will be set on the target.
  22  *
  23  * @see ProxyGraphicsTarget
  24  * @since 2022/02/25
  25  */
  26 public final class ProxyGraphics
  27         extends Graphics
  28 {
  29         /** The target graphics to draw into. */
  30         protected final ProxyGraphicsTarget target;
  31
  32         /** The current alpha color. */
  33         private int _argbColor;
  34
  35         /** The current blending mode. */
  36         private int _blendingMode;
  37
  38         /** The clip height. */
  39         private int _clipHeight;
  40
  41         /** The clip width. */
  42         private int _clipWidth;
  43
  44         /** The clip X position. */
  45         private int _clipX;
  46
  47         /** The clip Y position. */
  48         private int _clipY;
  49
  50         /** The current font used. */
  51         private Font _font;
  52
  53         /** The current stroke style. */
  54         private int _strokeStyle;
  55
  56         /** The current X translation. */
  57         private int _transX;
  58
  59         /** The current Y translation. */
  60         private int _transY;
  61
  62         /**
  63          * Initializes the proxy graphics with the given target.
  64          *
  65          * @param __target The target graphics proxy.
  66          * @param __width The graphics width.
  67          * @param __height The graphics height.
  68          * @throws NullPointerException On null arguments.
  69          * @since 2022/02/25
  70          */
  71         public ProxyGraphics(ProxyGraphicsTarget __target, int __width,
  72                 int __height)
  73                 throws NullPointerException
  74         {
  75                 if (__target == null)
  76                         throw new NullPointerException("NARG");
  77
  78                 this.target = __target;
  79                 this._clipWidth = __width;
  80                 this._clipHeight = __height;
  81         }
  82
  83         /**
  84          * {@inheritDoc}
  85          * @since 2022/02/25
  86          */
  87         @Override
  88         public void clipRect(int __a, int __b, int __c, int __d)
  89         {
  90                 throw Debugging.todo();
  91         }
  92
  93         /**
  94          * {@inheritDoc}
  95          * @since 2022/02/25
  96          */
  97         @Override
  98         public void copyArea(int __a, int __b, int __c, int __d, int __e,
  99                 int __f, int __g)
 100         {
 101                 this.__graphics().copyArea(__a, __b, __c, __d, __e, __f, __g);
 102         }
 103
 104         /**
 105          * {@inheritDoc}
 106          * @since 2022/02/25
 107          */
 108         @Override
 109         public void drawArc(int __a, int __b, int __c, int __d, int __e,
 110                 int __f)
 111         {
 112                 this.__graphics().drawArc(__a, __b, __c, __d, __e, __f);
 113         }
 114
 115         /**
 116          * {@inheritDoc}
 117          * @since 2022/02/25
 118          */
 119         @Override
 120         public void drawARGB16(short[] __data, int __off, int __scanlen,
 121                 int __x, int __y, int __w, int __h)
 122         {
 123                 this.__graphics().drawARGB16(__data, __off, __scanlen, __x, __y, __w,
 124                         __h);
 125         }
 126
 127         /**
 128          * {@inheritDoc}
 129          * @since 2022/02/25
 130          */
 131         @Override
 132         public void drawChar(char __a, int __b, int __c, int __d)
 133         {
 134                 this.__graphics().drawChar(__a, __b, __c, __d);
 135         }
 136
 137         /**
 138          * {@inheritDoc}
 139          * @since 2022/02/25
 140          */
 141         @Override
 142         public void drawChars(char[] __a, int __b, int __c, int __d,
 143                 int __e, int __f)
 144         {
 145                 this.__graphics().drawChars(__a, __b, __c, __d, __e, __f);
 146         }
 147
 148         /**
 149          * {@inheritDoc}
 150          * @since 2022/02/25
 151          */
 152         @Override
 153         public void drawImage(Image __a, int __b, int __c, int __d)
 154         {
 155                 this.__graphics().drawImage(__a, __b, __c, __d);
 156         }
 157
 158         /**
 159          * {@inheritDoc}
 160          * @since 2022/02/25
 161          */
 162         @Override
 163         public void drawLine(int __a, int __b, int __c, int __d)
 164         {
 165                 this.__graphics().drawLine(__a, __b, __c, __d);
 166         }
 167
 168         /**
 169          * {@inheritDoc}
 170          * @since 2022/02/25
 171          */
 172         @Override
 173         public void drawRGB(int[] __a, int __b, int __c, int __d, int __e,
 174                 int __f, int __g, boolean __h)
 175         {
 176                 this.__graphics().drawRGB(__a, __b, __c, __d, __e, __f, __g, __h);
 177         }
 178
 179         /**
 180          * {@inheritDoc}
 181          * @since 2022/02/25
 182          */
 183         @Override
 184         public void drawRGB16(short[] __data, int __off, int __scanlen,
 185                 int __x, int __y, int __w, int __h)
 186         {
 187                 this.__graphics().drawRGB16(__data, __off, __scanlen, __x, __y, __w, __h);
 188         }
 189
 190         /**
 191          * {@inheritDoc}
 192          * @since 2022/02/25
 193          */
 194         @Override
 195         public void drawRect(int __a, int __b, int __c, int __d)
 196         {
 197                 this.__graphics().drawRect(__a, __b, __c, __d);
 198         }
 199
 200         /**
 201          * {@inheritDoc}
 202          * @since 2022/02/25
 203          */
 204         @Override
 205         public void drawRegion(Image __a, int __b, int __c, int __d,
 206                 int __e, int __f, int __g, int __h, int __i)
 207         {
 208                 this.__graphics().drawRegion(__a, __b, __c, __d, __e, __f, __g, __h,
 209                         __i);
 210         }
 211
 212         /**
 213          * {@inheritDoc}
 214          * @since 2022/02/25
 215          */
 216         @Override
 217         public void drawRegion(Image __src, int __xsrc, int __ysrc,
 218                 int __w, int __h, int __trans, int __xdest, int __ydest, int __anch,
 219                 int __wdest, int __hdest)
 220         {
 221                 this.__graphics().drawRegion(__src, __xsrc, __ysrc, __w, __h, __trans,
 222                         __xdest, __ydest, __anch, __wdest, __hdest);
 223         }
 224
 225         /**
 226          * {@inheritDoc}
 227          * @since 2022/02/25
 228          */
 229         @Override
 230         public void drawRoundRect(int __a, int __b, int __c, int __d,
 231                 int __e,  int __f)
 232         {
 233                 this.__graphics().drawRoundRect(__a, __b, __c, __d, __e, __f);
 234         }
 235
 236         /**
 237          * {@inheritDoc}
 238          * @since 2022/02/25
 239          */
 240         @Override
 241         public void drawString(String __a, int __b, int __c, int __d)
 242         {
 243                 this.__graphics().drawString(__a, __b, __c, __d);
 244         }
 245
 246         /**
 247          * {@inheritDoc}
 248          * @since 2022/02/25
 249          */
 250         @Override
 251         public void drawSubstring(String __a, int __b, int __c, int __d,
 252                 int __e, int __f)
 253         {
 254                 this.__graphics().drawSubstring(__a, __b, __c, __d, __e, __f);
 255         }
 256
 257         /**
 258          * {@inheritDoc}
 259          * @since 2022/02/25
 260          */
 261         @Override
 262         public void drawText(Text __t, int __x, int __y)
 263         {
 264                 this.__graphics().drawText(__t, __x, __y);
 265         }
 266
 267         /**
 268          * {@inheritDoc}
 269          * @since 2022/02/25
 270          */
 271         @Override
 272         public void fillArc(int __a, int __b, int __c, int __d, int __e,
 273                 int __f)
 274         {
 275                 this.__graphics().fillArc(__a, __b, __c, __d, __e, __f);
 276         }
 277
 278         /**
 279          * {@inheritDoc}
 280          * @since 2022/02/25
 281          */
 282         @Override
 283         public void fillRect(int __x, int __y, int __w, int __h)
 284         {
 285                 this.__graphics().fillRect(__x, __y, __w, __h);
 286         }
 287
 288         /**
 289          * {@inheritDoc}
 290          * @since 2022/02/25
 291          */
 292         @Override
 293         public void fillRoundRect(int __a, int __b, int __c, int __d,
 294                 int __e, int __f)
 295         {
 296                 this.__graphics().fillRoundRect(__a, __b, __c, __d, __e, __f);
 297         }
 298
 299         /**
 300          * {@inheritDoc}
 301          * @since 2022/02/25
 302          */
 303         @Override
 304         public void fillTriangle(int __a, int __b, int __c, int __d,
 305                 int __e, int __f)
 306         {
 307                 this.__graphics().fillTriangle(__a, __b, __c, __d, __e, __f);
 308         }
 309
 310         /**
 311          * {@inheritDoc}
 312          * @since 2022/02/25
 313          */
 314         @Override
 315         public int getAlpha()
 316         {
 317                 return (this._argbColor >> 24) & 0xFF;
 318         }
 319
 320         /**
 321          * {@inheritDoc}
 322          * @since 2017/02/10
 323          */
 324         @Override
 325         public int getAlphaColor()
 326         {
 327                 return this._argbColor;
 328         }
 329
 330         /**
 331          * {@inheritDoc}
 332          * @since 2022/02/25
 333          */
 334         @Override
 335         public int getBlendingMode()
 336         {
 337                 return this._blendingMode;
 338         }
 339
 340         /**
 341          * {@inheritDoc}
 342          * @since 2022/02/25
 343          */
 344         @Override
 345         public int getBlueComponent()
 346         {
 347                 return (this._argbColor) & 0xFF;
 348         }
 349
 350         /**
 351          * {@inheritDoc}
 352          * @since 2022/02/25
 353          */
 354         @Override
 355         public int getClipHeight()
 356         {
 357                 return this._clipHeight;
 358         }
 359
 360         /**
 361          * {@inheritDoc}
 362          * @since 2022/02/25
 363          */
 364         @Override
 365         public int getClipWidth()
 366         {
 367                 return this._clipWidth;
 368         }
 369
 370         /**
 371          * {@inheritDoc}
 372          * @since 2022/02/25
 373          */
 374         @Override
 375         public int getClipX()
 376         {
 377                 return this._clipX - this._transX;
 378         }
 379
 380         /**
 381          * {@inheritDoc}
 382          * @since 2022/02/25
 383          */
 384         @Override
 385         public int getClipY()
 386         {
 387                 return this._clipY - this._transY;
 388         }
 389
 390         /**
 391          * {@inheritDoc}
 392          * @since 2022/02/25
 393          */
 394         @Override
 395         public int getColor()
 396         {
 397                 return this._argbColor & 0xFFFFFF;
 398         }
 399
 400         /**
 401          * {@inheritDoc}
 402          * @since 2022/02/25
 403          */
 404         @Override
 405         public int getDisplayColor(int __a)
 406         {
 407                 return this.__graphics().getDisplayColor(__a);
 408         }
 409
 410         /**
 411          * {@inheritDoc}
 412          * @since 2022/02/25
 413          */
 414         @Override
 415         public Font getFont()
 416         {
 417                 return this.__font();
 418         }
 419
 420         /**
 421          * {@inheritDoc}
 422          * @since 2022/02/25
 423          */
 424         @Override
 425         public int getGrayScale()
 426         {
 427                 return (((this._argbColor >> 16) & 0xFF) +
 428                         ((this._argbColor >> 8) & 0xFF) +
 429                         ((this._argbColor) & 0xFF)) / 3;
 430         }
 431
 432         /**
 433          * {@inheritDoc}
 434          * @since 2022/02/25
 435          */
 436         @Override
 437         public int getGreenComponent()
 438         {
 439                 return (this._argbColor >> 8) & 0xFF;
 440         }
 441
 442         /**
 443          * {@inheritDoc}
 444          * @since 2022/02/25
 445          */
 446         @Override
 447         public int getRedComponent()
 448         {
 449                 return (this._argbColor >> 16) & 0xFF;
 450         }
 451
 452         /**
 453          * {@inheritDoc}
 454          * @since 2022/02/25
 455          */
 456         @Override
 457         public int getStrokeStyle()
 458         {
 459                 return this._strokeStyle;
 460         }
 461
 462         /**
 463          * {@inheritDoc}
 464          * @since 2022/02/25
 465          */
 466         @Override
 467         public int getTranslateX()
 468         {
 469                 return this._transX;
 470         }
 471
 472         /**
 473          * {@inheritDoc}
 474          * @since 2022/02/25
 475          */
 476         @Override
 477         public int getTranslateY()
 478         {
 479                 return this._transY;
 480         }
 481
 482         /**
 483          * {@inheritDoc}
 484          * @since 2022/02/25
 485          */
 486         @Override
 487         public void setAlpha(int __a)
 488         {
 489                 this.setAlphaColor(__a,
 490                         this.getRedComponent(),
 491                         this.getGreenComponent(),
 492                         this.getBlueComponent());
 493         }
 494
 495         /**
 496          * {@inheritDoc}
 497          * @since 2022/02/25
 498          */
 499         @Override
 500         public void setAlphaColor(int __argb)
 501         {
 502                 this._argbColor = __argb;
 503         }
 504
 505         /**
 506          * {@inheritDoc}
 507          * @since 2022/02/25
 508          */
 509         @Override
 510         public void setAlphaColor(int __a, int __r, int __g, int __b)
 511         {
 512                 // {@squirreljme.error EB2y Color out of range. (Alpha; Red; Green;
 513                 // Blue)}
 514                 if (__a < 0 || __a > 255 || __r < 0 || __r > 255 ||
 515                         __g < 0 || __g > 255 || __b < 0 || __b > 255)
 516                         throw new IllegalArgumentException(String.format(
 517                                 "EB2y %d %d %d %d", __a, __r, __g, __b));
 518
 519                 // Set
 520                 this.setAlphaColor((__a << 24) | (__r << 16) | (__g << 8) | __b);
 521         }
 522
 523         /**
 524          * {@inheritDoc}
 525          * @since 2022/02/25
 526          */
 527         @Override
 528         public void setBlendingMode(int __m)
 529         {
 530                 // {@squirreljme.error EB2x Invalid blending mode. (The mode)}
 531                 if (__m != Graphics.SRC && __m != Graphics.SRC_OVER)
 532                         throw new IllegalArgumentException("EB2x " + __m);
 533
 534                 // Cache locally
 535                 this._blendingMode = __m;
 536         }
 537
 538         /**
 539          * {@inheritDoc}
 540          * @since 2022/02/25
 541          */
 542         @Override
 543         public void setClip(int __x, int __y, int __w, int __h)
 544         {
 545                 // Calculate the base clip coordinates
 546                 int startX = __x + this._transX;
 547                 int startY = __y + this._transY;
 548                 int endX = startX + __w;
 549                 int endY = startY + __h;
 550
 551                 // Normalize X
 552                 if (endX < startX)
 553                 {
 554                         int temp = endX;
 555                         endX = startX;
 556                         startX = temp;
 557                 }
 558
 559                 // Normalize Y
 560                 if (endY < startY)
 561                 {
 562                         int temp = endY;
 563                         endY = startY;
 564                         startY = temp;
 565                 }
 566
 567                 // Determine the bounds of all of these
 568                 int clipX = Math.max(0, startX);
 569                 int clipY = Math.max(0, startY);
 570                 int clipEndX = Math.max(0, endX);
 571                 int clipEndY = Math.max(0, endY);
 572
 573                 // Record internally
 574                 this._clipX = clipX;
 575                 this._clipY = clipY;
 576                 this._clipWidth = clipEndX - clipX;
 577                 this._clipHeight = clipEndY - clipY;
 578         }
 579
 580         /**
 581          * {@inheritDoc}
 582          * @since 2022/02/25
 583          */
 584         @Override
 585         public void setColor(int __rgb)
 586         {
 587                 this.setAlphaColor((this.getAlphaColor() & 0xFF_000000) |
 588                         (__rgb & 0x00_FFFFFF));
 589         }
 590
 591         /**
 592          * {@inheritDoc}
 593          * @since 2022/02/25
 594          */
 595         @Override
 596         public void setColor(int __r, int __g, int __b)
 597         {
 598                 this.setAlphaColor(this.getAlpha(), __r, __g, __b);
 599         }
 600
 601         /**
 602          * {@inheritDoc}
 603          * @since 2022/02/25
 604          */
 605         @Override
 606         public void setFont(Font __font)
 607         {
 608                 this.__graphics().setFont(__font);
 609         }
 610
 611         /**
 612          * {@inheritDoc}
 613          * @since 2022/02/25
 614          */
 615         @Override
 616         public void setGrayScale(int __v)
 617         {
 618                 this.setAlphaColor(this.getAlpha(), __v, __v, __v);
 619         }
 620
 621         /**
 622          * {@inheritDoc}
 623          * @since 2022/02/25
 624          * @param __style
 625          */
 626         @Override
 627         public void setStrokeStyle(int __style)
 628         {
 629                 // {@squirreljme.error EB2z Illegal stroke style.}
 630                 if (__style != Graphics.SOLID && __style != Graphics.DOTTED)
 631                         throw new IllegalArgumentException("EB2z");
 632
 633                 // Set
 634                 this._strokeStyle = __style;
 635         }
 636
 637         /**
 638          * {@inheritDoc}
 639          * @since 2022/02/25
 640          */
 641         @Override
 642         public void translate(int __x, int __y)
 643         {
 644                 // Cache locally
 645                 this._transX += __x;
 646                 this._transY += __y;
 647         }
 648
 649         /**
 650          * Returns the font that should be used.
 651          *
 652          * @return The font used.
 653          * @since 2022/02/25
 654          */
 655         private Font __font()
 656         {
 657                 Font rv = this._font;
 658                 if (rv == null)
 659                         rv = Font.getDefaultFont();
 660                 return rv;
 661         }
 662
 663         /**
 664          * Initializes and returns the target graphics accordingly.
 665          *
 666          * @return The resultant graphics object.
 667          * @since 2022/02/25
 668          */
 669         private Graphics __graphics()
 670         {
 671                 // This is the graphics we are drawing into
 672                 Graphics target = this.target._target;
 673
 674                 // Pass all the adjustable parameters to the target
 675                 target.setAlphaColor(this._argbColor);
 676                 target.setBlendingMode(this._blendingMode);
 677                 target.setFont(this.__font());
 678                 target.setStrokeStyle(this._strokeStyle);
 679
 680                 // Translation that is needed for clipping and translation
 681                 int targetTransX = target.getTranslateX();
 682                 int targetTransY = target.getTranslateY();
 683
 684                 // Set absolute clipping area
 685                 target.setClip(
 686                         this._clipX - targetTransX, this._clipY - targetTransY,
 687                         this._clipWidth, this._clipHeight);
 688                 target.translate(this._transX - targetTransX,
 689                         this._transY - targetTransY);
 690
 691                 // Return the graphics we are drawing into
 692                 return target;
 693         }
 694 }