グラフィックスオブジェクトの変更

この例では、MATLAB® でグラフィックスオブジェクトを作成、表示、変更する方法を示します。

グラフィックスオブジェクト

MATLAB でプロットを作成すると、一連のグラフィックスオブジェクトが作成されます。figure、axes、line、patch、text などがグラフィックスオブジェクトの例です。次の Figure には、axes、line、text の 3 つのグラフィックスオブジェクトがあります。オプションの出力引数を使用して、作成されたグラフィックスオブジェクトを保存します。

x = -pi:pi/20:pi;
y = sin(x);

f = figure;
p = plot(x,y);
txt1 = text(0.2,0,'sin(x)');

すべてのグラフィックスオブジェクトには、表示および変更可能なプロパティがあります。こうしたプロパティには既定値があります。line オブジェクト p を表示すると、Color、LineStyle、LineWidth など、最もよく使用されるラインプロパティが示されます。

p = 
  Line with properties:

              Color: [0 0.4470 0.7410]
          LineStyle: '-'
          LineWidth: 0.5000
             Marker: 'none'
         MarkerSize: 6
    MarkerFaceColor: 'none'
              XData: [-3.1416 -2.9845 -2.8274 -2.6704 -2.5133 -2.3562 -2.1991 -2.0420 -1.8850 -1.7279 -1.5708 -1.4137 -1.2566 -1.0996 -0.9425 -0.7854 -0.6283 -0.4712 -0.3142 -0.1571 0 0.1571 0.3142 0.4712 0.6283 0.7854 0.9425 1.0996 ... ] (1x41 double)
              YData: [-1.2246e-16 -0.1564 -0.3090 -0.4540 -0.5878 -0.7071 -0.8090 -0.8910 -0.9511 -0.9877 -1 -0.9877 -0.9511 -0.8910 -0.8090 -0.7071 -0.5878 -0.4540 -0.3090 -0.1564 0 0.1564 0.3090 0.4540 0.5878 0.7071 0.8090 0.8910 ... ] (1x41 double)

  Use GET to show all properties

MATLAB では、オブジェクトを作成するコマンドにセミコロンがない場合も同様に表示されます。

txt2 = text(x(end), y(end), 'pi')

txt2 = 
  Text (pi) with properties:

                 String: 'pi'
               FontSize: 10
             FontWeight: 'normal'
               FontName: 'Helvetica'
                  Color: [0 0 0]
    HorizontalAlignment: 'left'
               Position: [3.1416 1.2246e-16 0]
                  Units: 'data'

  Use GET to show all properties

グラフィックスオブジェクトプロパティの取得

グラフィックスオブジェクトの個々のプロパティにアクセスするには、ドット表記構文 object.PropertyName を使用します。たとえば、line オブジェクトの LineWidth プロパティを返します。

pcol = p.LineWidth

pcol = 0.5000

ラインの色を赤に変更するには、その Color プロパティを設定します。

p.Color = 'red';

親と子

MATLAB では、グラフィックスオブジェクトが階層的に構成されています。階層の最上位は、"グラフィックスルート" と呼ばれる特別なオブジェクトです。グラフィックスルートにアクセスするには、関数 groot を使用します。

groot

ans = 
  Graphics Root with properties:

          CurrentFigure: [1x1 Figure]
    ScreenPixelsPerInch: 100
             ScreenSize: [1 1 1280 1024]
       MonitorPositions: [1 1 1280 1024]
                  Units: 'pixels'

  Use GET to show all properties

すべてのグラフィックスオブジェクト (ルートを除く) には親があります。たとえば、axes の親は figure です。

ax = gca;
ax.Parent

ans = 
  Figure (1) with properties:

      Number: 1
        Name: ''
       Color: [1 1 1]
    Position: [348 376 583 437]
       Units: 'pixels'

  Use GET to show all properties

多くのオブジェクトには子もあります。この axes には、2 つの text オブジェクトと 1 つの line オブジェクトという 3 つの子があります。

ax.Children

ans = 
  3x1 graphics array:

  Text    (pi)
  Text    (sin(x))
  Line

axes には複数の子があるため、Children プロパティの値はグラフィックスオブジェクトの配列になります。axes の子に個別にアクセスするには、この配列にインデックスを付けます。これにより、子オブジェクトのプロパティを設定できるようになります。

t = ax.Children(2);
t.FontWeight = 'bold';

グラフィックスオブジェクト配列の事前割り当て

MATLAB では、配列を使用する前の事前割り当てをお勧めしています。グラフィックスオブジェクトの配列に事前の割り当てを行うには、gobjects コマンドを使用します。これにより、グラフィックスオブジェクトを配列に追加できるようになります。

objarray = gobjects(1,5);
objarray(1) = f;
objarray(2) = ax;
objarray(3) = p;
objarray(4) = txt1;
objarray(5) = txt2;
objarray

objarray = 
  1x5 graphics array:

    Figure    Axes      Line      Text      Text

すべてのオブジェクトプロパティの取得

MATLAB のグラフィックスオブジェクトには多数のプロパティがあります。オブジェクトのすべてのプロパティを確認するには、get コマンドを使用します。

get(f)

                 Alphamap: [0 0.0159 0.0317 0.0476 0.0635 0.0794 0.0952 0.1111 0.1270 0.1429 0.1587 0.1746 0.1905 0.2063 0.2222 0.2381 0.2540 0.2698 0.2857 0.3016 0.3175 0.3333 0.3492 0.3651 0.3810 0.3968 0.4127 0.4286 0.4444 0.4603 ... ] (1x64 double)
             BeingDeleted: off
               BusyAction: 'queue'
            ButtonDownFcn: ''
                 Children: [1x1 Axes]
                 Clipping: on
          CloseRequestFcn: 'closereq'
                    Color: [1 1 1]
                 Colormap: [256x3 double]
              ContextMenu: [0x0 GraphicsPlaceholder]
                CreateFcn: ''
              CurrentAxes: [1x1 Axes]
         CurrentCharacter: ''
            CurrentObject: [0x0 GraphicsPlaceholder]
             CurrentPoint: [0 0]
                DeleteFcn: ''
             DockControls: on
                 FileName: ''
        GraphicsSmoothing: on
         HandleVisibility: 'on'
                     Icon: ''
            InnerPosition: [348 376 583 437]
            IntegerHandle: on
            Interruptible: on
           InvertHardcopy: on
              KeyPressFcn: ''
            KeyReleaseFcn: ''
                  MenuBar: 'none'
                     Name: ''
                 NextPlot: 'add'
                   Number: 1
              NumberTitle: on
            OuterPosition: [348 376 583 437]
         PaperOrientation: 'portrait'
            PaperPosition: [1.3350 3.3150 5.8300 4.3700]
        PaperPositionMode: 'auto'
                PaperSize: [8.5000 11]
                PaperType: 'usletter'
               PaperUnits: 'inches'
                   Parent: [1x1 Root]
                  Pointer: 'arrow'
        PointerShapeCData: [16x16 double]
      PointerShapeHotSpot: [1 1]
                 Position: [348 376 583 437]
                 Renderer: 'opengl'
             RendererMode: 'auto'
                   Resize: on
               Scrollable: off
            SelectionType: 'normal'
           SizeChangedFcn: ''
                      Tag: ''
                  ToolBar: 'none'
                     Type: 'figure'
                    Units: 'pixels'
                 UserData: []
                  Visible: off
      WindowButtonDownFcn: ''
    WindowButtonMotionFcn: ''
        WindowButtonUpFcn: ''
        WindowKeyPressFcn: ''
      WindowKeyReleaseFcn: ''
     WindowScrollWheelFcn: ''
              WindowState: 'normal'
              WindowStyle: 'normal'
                 XDisplay: ':99'

グラフィックス オブジェクトの変更