# Copyright (c) 2025-2026 Gigasoft, Inc. All rights reserved.
=== ProEssentials Styling (knowledge rev 4) & Appearance ===

ProEssentials styling is controlled through PeColor, PeFont, PeConfigure,
and PePlot property groups. ALWAYS query pe_query.py for exact paths.

COLOR SYSTEM (PeColor group):
  SubsetColors[] -- per-series colors (the primary palette)
  GraphForeground / GraphBackground -- graph area colors
  Desk -- background behind titles and labels (NOT "DeskColor")
  Text -- foreground for titles and labels (NOT "TextColor")
  Shadow -- drop shadow color (NOT "ShadowColor")
  YAxis / RYAxis / XAxis -- axis line colors
  GridLineColor -- grid line color with GridLineAlpha transparency
  NOTE: Color property names are often SHORT. Never guess full names.
  Query: pe_query.py props --category color --list

QUICK STYLING:
  ViewingStyle enum -- broad visual themes (Color, Monochrome, etc.)
  QuickStyle enum -- predefined color schemes (numbered presets)
  BitmapGradientMode -- enable gradient backgrounds
  Set BitmapGradientMode BEFORE QuickStyle for gradient schemes.

FONT SIZING (PeFont group):
  All font sizes use a proportional control system with "Cntl" suffix:
  SizeTitleCntl, SizeSubTitleCntl, SizeLegendCntl, SizeAxisLabelCntl,
  SizeGridNumberCntl, etc. Values are percentages (100 = default).
  Font families: MainTitle.Font, SubTitle.Font, Label.Font (string names).
  Bold/Italic: MainTitle.Bold, SubTitle.Italic, etc.
  NOTE: Font size property names use abbreviations (not "FontSizeAxisLabel"
  but "SizeAxisLabelCntl"). Always verify with pe_query.py.

DATA VISUALIZATION:
  DataShadows enum -- 3D shadow effects on bars/points
  PointSize -- size of scatter points
  LineSymbolSize -- size of line markers
  BarWidth / BarGap -- bar chart spacing
  SubsetLineTypes[] -- per-series line styles (solid, dash, dot, etc.)

RENDERING ENGINE:
  RenderEngine enum: GDI (default), Direct3D (GPU), Direct2D
  Direct3D enables: 3D surfaces, compute shaders, GPU-accelerated rendering.
  GDI is standard for 2D charts, broadest compatibility.

TITLES AND LABELS (PeString group):
  MainTitle, SubTitle -- chart titles
  YAxisLabel, XAxisLabel, RYAxisLabel -- axis labels
  SubsetLabels[] -- legend entries per series
  PointLabels[] -- X-axis category labels (Pego)

KEY: pe_query.py props "ViewingStyle,QuickStyle,SubsetColors"
  pe_query.py enum "ViewingStyle"
  pe_query.py search "gradient"