より良いプログラムを書くための究極の奇策 – 「Data first, not code first」

(訳注：2015/10/31、いただいた翻訳フィードバックを元に記事を修正いたしました。)

開発者は嫌うでしょう。

ここでは、標準的なコツや策略について書きますが、本当に興味があるのは、別のことです。究極の奇策を見つけたいと思います。策略をひとつずつ試して、プログラミングの聖域に少しでも近づければ良いのですが。

はじめに

私が初めて書いたビデオゲームは、Ninja Wars（忍者戦争）でした。


そう、これは、画像で埋めたHTMLのtableです。src属性を変えることで、動きを実現しています。JavaScriptファイルの冒頭は下記のようになっています。

  1. var x = 314; 
  2. var y = 8; 
  3. var prevy= 1; 
  4. var prevx= 1; 
  5. var prevsw= 0; 
  6. var row= 304; 
  7. var endrow= 142; 
  8. var sword= 296; 
  9. var yrow = 0; 
  10. var yendrow = 186; 
  11. var I = 0; 
  12. var e = 0; 
  13. var counter = 0; 
  14. var found = 0; 
  15. var esword = 26; 
  16. var eprevsw = 8; 
  17. var bluehealth = 40; 
  18. var redhealth = 40; 
  19. var n = 0; 
  20. var you = 'ninja'; 
  21. var bullet = 'sword'; 
  22. var enemy = 'enemy'; 
  23. var ebullet = 'enemysword'; 
  24. var besieged = 0; 
  25. var siegecount = 0; 
  26. var esiegecount = 0; 
  27. var ebesieged = 0; 
  28. var healthcount = 0; 
  29. var player = 0; 
  30. var starcount = 0; 
  31. var infortress = false; 
  32. var prevyou = you; 
  33. var einfortress = false; 
  34. var prevenemy = enemy; 
  35. var previmg = ""; 
  36. var prevbullet= ""; 
  37. var eprevbullet= ""; 
  38. var randnum = 0; 
  39. var randnum2 = 0; 
  40. var randnum3 = 0; 
  41. var randnum4 = 0; 
  42. var buildcount = 0; var 
  43. characters = new Array(4); 
  44. characters = ['ninja','tank','heli','builder']; 
  45. var bullets = new Array(3); 
  46. bullets = ['sword','bullet','5cal','sword']; 
  47. var echaracters = new Array(3); 
  48. echaracters = ['enemy','tank2','eheli','ebuilder']; 
  49. var ebullets = new Array(3); 
  50. ebullets = ['enemysword','bullet2','e5cal','enemysword']; 
  51. var health = new Array(4); 
  52. health = [40,30,20,10]; 
  53. var prevorb = 0; 
  54. var prevnum = 0;

見たことのあるコードだと思います。このようなコードでプログラムを書き始めているのは私だけではありません。しかしながら、(プログラミングの定石のように見える) この部分が実は大間違いです。従って、この部分に対する私の提案が、策略その1となります。

策略その1:　グローバル変数は悪である

この時点では、グローバル変数がなぜ悪なのか説明することはできません。直観的に違うと感じているのです。

追記：今はグローバル変数に対して否定的ではないことをはっきりと言っておきます。でも、先走ってしまうことになるので、ここでは否定的な観点から話をします。

オブジェクトについてはこの後触れますが、変数は次のようにまとめることができます。

  1. class Ninja 
  2. { 
  3.     int x, y; 
  4.     int previousX, previousY; 
  5.     int health = 100; 
  6. } 
  7.  
  8. class Sword 
  9. { 
  10.     int x, y; 
  11.     int previousX, previousY; 
  12.     int sharpness = 9000; 
  13. }

さらにここで継承を使えば、コピー＆ペーストの手間を省くことができます。

  1. class Movable 
  2. {
  3.     int x, y; 
  4.     int previousX, previousY; 
  5. } 
  6.  
  7. class Ninja : public Movable 
  8. { 
  9.     int health = 100; 
  10. } 
  11.  
  12. class Sword : public Movable 
  13. { 
  14.     int sharpness = 9000; 
  15. }

継承は便利です。次の策略にも使えます。

策略その2：オブジェクト指向プログラミング

オブジェクト指向プログラミングは最高で、昔ながらのビデオゲームの多くのコア部分となっています。Doom 3のコア部分もそうであり、偶然にもオープンソースとなっています。

Doom 3には継承が多用されています。信じられない？　このゲームのクラス階層のサブセットの一部は以下の通りです。

  1. idClass
  2.      idEntity
  3.         idAnimatedEntity
  4.             idWeapon 
  5.             idAFEntity_Base 
  6.                 idAFEntity_ClawFourFingers 
  7.                 idAFEntity_Vehicle 
  8.                     idAFEntity_VehicleFourWheels 
  9.                     idAFEntity_VehicleSixWheels 
  10.                 idAFEntity_Gibbable 
  11.                     idAFEntity_WithAttachedHead 
  12.                     idActor 
  13.                         idPlayer 
  14.                         idAI

仮に、あなたがid Softwareの社員だったとします。この継承階層は最初の数カ月は順調に機能するでしょう。そして、ある運命的な月曜日、大惨事が起こります。ボスに呼ばれ、「計画変更だ。プレーヤーを車にする。」と言われます。

階層のidPlayerとidAFEntitiy_VehicleFourWheelsを見て下さい。大問題その1です。多くのコードをいじる必要があります。

大問題その2です。ボスが正気に戻り、「プレーヤーを車にする」案を取り消します。その代わりに、全てに砲塔を装備すると言い出しました。車はHalo Warthog（車体後部に機関銃を装備した四輪駆動車）となり、プレーヤーは大型の砲塔を背負います。

ずぼらなプログラマなので、コピー＆ペーストの作業を省くために、また継承を使います。しかし、階層を見てください。砲塔のコードはどこに書き込めばよいのでしょうか。idPlayerとidAFEntity_VehicleFourWheelsの共通の親はidAFEntity_Baseのみです。

そのため、恐らくidAFEntity_Baseにコードを書き込み、calledturret_is_activeのブーリアンフラグを追加します。この時、車とプレーヤーのみをTRUEに設定します。これで確かに機能しますが、その結果、あまりにも多くのものがベース階層に書き込まれすぎてしまっています。idEntityのソースコードは次のとおりです。

スクロールして見てください。全部見る必要はありません。

  1. class idEntity : public idClass { 
  2. public: 
  3.     static const int        MAX_PVS_AREAS = 4; 
  4.     static const uint32     INVALID_PREDICTION_KEY = 0xFFFFFFFF; 
  5.  
  6.     int                      entityNumber;  // index into the entity list 
  7.     int                      entityDefNumber;   // index into the entity def list 
  8.  
  9.     idLinkList<idEntity>    spawnNode;  // for being linked into spawnedEntities list
  10.     idLinkList<idEntity>    activeNode; // for being linked into activeEntities list
  11.     idLinkList<idEntity>    aimAssistNode;  // linked into gameLocal.aimAssistEntities
  12.  
  13.     idLinkList<idEntity>    snapshotNode;   // for being linked into snapshotEntities list
  14.     int                       snapshotChanged;  // used to detect snapshot state changes
  15.     int              snapshotBits;    // number of bits this entity occupied in the last snapshot
  16.     bool              snapshotStale; // Set to true if this entity is considered stale in the snapshot
  17.  
  18.     idStr                 name;                    // name of entity
  19.     idDict                spawnArgs; // key/value pairs used to spawn and initialize entity
  20.     idScriptObject       scriptObject; // contains all script defined data for this entity
  21.  
  22.     int                   thinkFlags;                // TH_? Flags
  23.     int                   dormantStart;   // time that the entity was first closed off from player
  24.     bool                  cinematic; // during cinematics, entity will only think if cinematic is set 
  25.  
  26.     renderView_t *            renderView;                // for camera views from this entity
  27.     idEntity *                cameraTarget;           // any remoteRenderMap shaders will use this
  28.  
  29.     idList< idEntityPtr<idEntity>, TAG_ENTITY > targets; // when this entity is activated these entities entity are activated  
  30.  
  31.     int                        health;                    // FIXME: do all objects really need health? 
  32.  
  33.     struct entityFlags_s {  
  34.       bool       notarget            :1;    // if true never attack or target this entity
  35.       bool       noknockback         :1;    // if true no knockback from hits
  36.       bool       takedamage          :1;    // if true this entity can be damaged
  37.       bool       hidden               :1;    // if true this entity is not visible
  38.       bool       bindOrientated      :1;    // if true both the master orientation is used for binding
  39.       bool       solidForTeam        :1;    // if true this entity is considered solid when a physics team mate pushes entities
  40.       bool       forcePhysicsUpdate    :1;    // if true always update from the physics whether the object moved or not
  41.       bool       selected            :1;    // if true the entity is selected for editing
  42.       bool       neverDormant        :1;    // if true the entity never goes dormant
  43.       bool       isDormant            :1;    // if true the entity is dormant
  44.       bool       hasAwakened            :1;    // before a monster has been awakened the first time, use full PVS for dormant instead of area-connected
  45.       bool       networkSync            :1; // if true the entity is synchronized over the network
  46.       bool       grabbed                :1;    // if true object is currently being grabbed
  47.       bool       skipReplication        :1; // don't replicate this entity over the network.     
  48.     } fl;      
  49.  
  50.     int                        timeGroup;
  51.  
  52.     bool                    noGrab;      
  53.  
  54.     renderEntity_t            xrayEntity;
  55.     qhandle_t                xrayEntityHandle;
  56.     const idDeclSkin *        xraySkin;
  57.  
  58.     void                    DetermineTimeGroup( bool slowmo ); 
  59.  
  60.     void                    SetGrabbedState( bool grabbed );
  61.     bool                    IsGrabbed();
  62.  
  63.  public: 
  64.     ABSTRACT_PROTOTYPE( idEntity ); 
  65.                              idEntity(); 
  66.                             ~idEntity(); 
  67.     void                    Spawn(); 
  68.  
  69.     void                    Save( idSaveGame *savefile ) const; 
  70.     void                    Restore( idRestoreGame *savefile );
  71.  
  72.     const char *            GetEntityDefName() const; 
  73.     void                    SetName( const char *name ); 
  74.     const char *            GetName() const; 
  75.     virtual void            UpdateChangeableSpawnArgs( const idDict *source ); 
  76.     int                      GetEntityNumber() const { return entityNumber; }
  77.                    // clients generate views based on all the player specific options,
  78.                    // cameras have custom code, and everything else just uses the axis orientation
  79.     virtual renderView_t *    GetRenderView();      // thinking 
  80.     virtual void            Think();
  81.     bool                    CheckDormant();    // dormant == on the active list, but out of PVS
  82.     virtual void            DormantBegin();    // called when entity becomes dormant
  83.     virtual void            DormantEnd();        // called when entity wakes from being dormant
  84.     bool                    IsActive() const;
  85.     void                    BecomeActive( int flags );
  86.     void                    BecomeInactive( int flags );
  87.     void                    UpdatePVSAreas( const idVec3 &pos );
  88.     void                    BecomeReplicated();
  89.  
  90.     // visuals
  91.     virtual void            Present();     virtual renderEntity_t *GetRenderEntity();
  92.     virtual int                GetModelDefHandle();
  93.     virtual void            SetModel( const char *modelname );
  94.     void                    SetSkin( const idDeclSkin *skin );
  95.     const idDeclSkin *        GetSkin() const;
  96.     void                    SetShaderParm( int parmnum, float value );
  97.     virtual void            SetColor( float red, float green, float blue );
  98.     virtual void            SetColor( const idVec3 &color );
  99.     virtual void            GetColor( idVec3 &out ) const;
  100.     virtual void            SetColor( const idVec4 &color );
  101.     virtual void            GetColor( idVec4 &out ) const;
  102.     virtual void            FreeModelDef();
  103.     virtual void            FreeLightDef();
  104.     virtual void            Hide();
  105.     virtual void            Show();
  106.     bool                    IsHidden() const;
  107.     void                    UpdateVisuals();
  108.     void                    UpdateModel(); 
  109.     void                    UpdateModelTransform();
  110.     virtual void            ProjectOverlay( const idVec3 &origin, const idVec3 &dir, float size, const char *material );
  111.     int                        GetNumPVSAreas();
  112.     const int *                GetPVSAreas();
  113.     void                    ClearPVSAreas();
  114.     bool                    PhysicsTeamInPVS( pvsHandle_t pvsHandle ); 
  115.  
  116.     // animation 
  117.     virtual bool            UpdateAnimationControllers();
  118.     bool                    UpdateRenderEntity( renderEntity_s *renderEntity, 
  119.     const renderView_t *renderView ); 
  120.     static bool                ModelCallback( renderEntity_s *renderEntity,
  121.     const renderView_t *renderView ); 
  122.     virtual idAnimator *    GetAnimator();    // returns animator object used by this entity 
  123.  
  124.     // sound
  125.     virtual bool            CanPlayChatterSounds() const;
  126.     bool                    StartSound( const char *soundName, const s_channelType channel, int soundShaderFlags, bool broadcast, int *length ); 
  127.     bool                    StartSoundShader( const idSoundShader *shader, const s_channelType channel, int soundShaderFlags, bool broadcast, int *length );     
  128.     void                    StopSound( const s_channelType channel, bool broadcast );    // pass SND_CHANNEL_ANY to stop all sounds 
  129.     void                    SetSoundVolume( float volume );
  130.     void                    UpdateSound();
  131.     int                        GetListenerId() const;     idSoundEmitter *        GetSoundEmitter() const;
  132.     void                    FreeSoundEmitter( bool immediate );
  133.  
  134.     // entity binding 
  135.     virtual void            PreBind();
  136.     virtual void            PostBind();
  137.     virtual void            PreUnbind();
  138.     virtual void            PostUnbind();
  139.     void                    JoinTeam( idEntity *teammember );
  140.     void                    Bind( idEntity *master, bool orientated );
  141.     void                    BindToJoint( idEntity *master, const char *jointname, bool orientated );
  142.     void                    BindToJoint( idEntity *master, jointHandle_t jointnum, bool orientated );
  143.     void                    BindToBody( idEntity *master, int bodyId, bool orientated ); 
  144.     void                    Unbind();
  145.     bool                    IsBound() const;
  146.     bool                    IsBoundTo( idEntity *master ) const;
  147.     idEntity *                GetBindMaster() const;
  148.     jointHandle_t            GetBindJoint() const;
  149.     int                        GetBindBody() const;
  150.     idEntity *                GetTeamMaster() const;
  151.     idEntity *                GetNextTeamEntity() const;
  152.     void                    ConvertLocalToWorldTransform( idVec3 &offset, idMat3 &axis );
  153.     idVec3                    GetLocalVector( const idVec3 &vec ) const;
  154.     idVec3                    GetLocalCoordinates( const idVec3 &vec ) const;
  155.     idVec3                    GetWorldVector( const idVec3 &vec ) const;
  156.     idVec3                    GetWorldCoordinates( const idVec3 &vec ) const;
  157.     bool                    GetMasterPosition( idVec3 &masterOrigin, idMat3 &masterAxis ) const;
  158.     void                    GetWorldVelocities( idVec3 &linearVelocity, idVec3 &angularVelocity ) const;
  159.  
  160.     // physics 
  161.                        // set a new physics object to be used by this entity
  162.     void               SetPhysics( idPhysics *phys ); 
  163.                        // get the physics object used by this entity
  164.     idPhysics *           GetPhysics() const; 
  165.                         // restore physics pointer for save games
  166.     void               RestorePhysics( idPhysics *phys );
  167.                         // run the physics for this entity
  168.     bool               RunPhysics();
  169.                        // Interpolates the physics, used on MP clients.
  170.     void               InterpolatePhysics( const float fraction );
  171. 　　　　　　　　　　　　// InterpolatePhysics actually calls evaluate, this version doesn't. 
  172.     void               InterpolatePhysicsOnly( const float fraction, bool updateTeam = false );
  173. 　　　　                // set the origin of the physics object (relative to bindMaster if not NULL)
  174.     void               SetOrigin( const idVec3 &org );  
  175.                         // set the axis of the physics object (relative to bindMaster if not NULL)
  176.     void               SetAxis( const idMat3 &axis );
  177. 　　　     　　　　　　// use angles to set the axis of the physics object (relative to bindMaster if not NULL) 
  178.     void                SetAngles( const idAngles &ang ); 
  179. 　　　　　　　　　　　　// get the floor position underneath the physics object
  180.     bool                    GetFloorPos( float max_dist, idVec3 &floorpos ) const; 
  181.                         // retrieves the transformation going from the physics origin/axis to the visual origin/axis 
  182.     virtual bool        GetPhysicsToVisualTransform( idVec3 &origin, idMat3 &axis );
  183. 　　　　　　　　        // retrieves the transformation going from the physics origin/axis to the sound origin/axis
  184.      virtual bool       GetPhysicsToSoundTransform( idVec3 &origin, idMat3 &axis ); 
  185.                           // called from the physics object when colliding, should return true if the physics simulation should stop     
  186.     virtual bool        Collide( const trace_t &collision, const idVec3 &velocity );
  187.                           // retrieves impact information, 'ent' is the entity retrieving the info
  188.     virtual void        GetImpactInfo( idEntity *ent, int id, const idVec3 &point, impactInfo_t *info ); 
  189. 　　　　　　　　　　　　　// apply an impulse to the physics object, 'ent' is the entity applying the impulse 
  190.     virtual void       　ApplyImpulse( idEntity *ent, int id, const idVec3 &point, const idVec3 &impulse );
  191. 　　　　　　　　　　　　　// add a force to the physics object, 'ent' is the entity adding the force
  192.     virtual void       AddForce( idEntity *ent, int id, const idVec3 &point, const idVec3 &force ); 
  193.                          // activate the physics object, 'ent' is the entity activating this entity
  194.     virtual void       ActivatePhysics( idEntity *ent );
  195.                           // returns true if the physics object is at rest
  196.     virtual bool            IsAtRest() const;
  197.                          // returns the time the physics object came to rest
  198.     virtual int                GetRestStartTime() const;
  199.                          // add a contact entity
  200.     virtual void       AddContactEntity( idEntity *ent );
  201.                           // remove a touching entity
  202.     virtual void       RemoveContactEntity( idEntity *ent );
  203.  
  204.     // damage
  205.                         // returns true if this entity can be damaged from the given origin
  206.     virtual bool      CanDamage( const idVec3 &origin, idVec3 &damagePoint ) const;
  207.                        // applies damage to this entity
  208.     virtual void            Damage( idEntity *inflictor, idEntity *attacker, const idVec3 &dir, const char *damageDefName, const float damageScale, const int location );
  209.                         // adds a damage effect like overlays, blood, sparks, debris etc.
  210.     virtual void            AddDamageEffect( const trace_t &collision, const idVec3 &velocity, const char *damageDefName );
  211.                         // callback function for when another entity received damage from this entity.  damage can be adjusted and returned to the caller.
  212.     virtual void            DamageFeedback( idEntity *victim, idEntity *inflictor, int &damage );
  213.                          // notifies this entity that it is in pain
  214.     virtual bool            Pain( idEntity *inflictor, idEntity *attacker, int damage, const idVec3 &dir, int location );
  215.                          // notifies this entity that is has been killed
  216.     virtual void            Killed( idEntity *inflictor, idEntity *attacker, int damage, const idVec3 &dir, int location );
  217.  
  218.     // scripting
  219.     virtual bool            ShouldConstructScriptObjectAtSpawn() const;
  220.     virtual idThread *        ConstructScriptObject();
  221.     virtual void            DeconstructScriptObject();
  222.     void                    SetSignal( signalNum_t signalnum, idThread *thread, const function_t *function );
  223.     void                    ClearSignal( idThread *thread, signalNum_t signalnum );
  224.     void                    ClearSignalThread( signalNum_t signalnum, idThread *thread );
  225.     bool                    HasSignal( signalNum_t signalnum ) const;
  226.     void                    Signal( signalNum_t signalnum );
  227.     void                    SignalEvent( idThread *thread, signalNum_t signalnum );
  228.  
  229.     // gui
  230.     void                    TriggerGuis();
  231.     bool                    HandleGuiCommands( idEntity *entityGui, const char *cmds );
  232.     virtual bool            HandleSingleGuiCommand( idEntity *entityGui, idLexer *src );
  233.  
  234.      // targets
  235.      void                    FindTargets();
  236.      void                    RemoveNullTargets();
  237.      void                    ActivateTargets( idEntity *activator ) const;
  238.  
  239.       // misc
  240.      virtual void            Teleport( const idVec3 &origin, const idAngles &angles, idEntity *destination );
  241.      bool                    TouchTriggers() const;     idCurve_Spline<idVec3> *GetSpline() const;
  242.      virtual void            ShowEditingDialog();
  243.  
  244.      enum {
  245.          EVENT_STARTSOUNDSHADER,
  246.          EVENT_STOPSOUNDSHADER,
  247.          EVENT_MAXEVENTS
  248.      };
  249.       // Called on clients in an MP game, does the actual interpolation for the entity.
  250.      // This function will eventually replace ClientPredictionThink completely.
  251.      virtual void            ClientThink( const int curTime, const float fraction, const bool predict );
  252.  
  253.      virtual void            ClientPredictionThink();
  254.      virtual void            WriteToSnapshot( idBitMsg &msg ) const;
  255.      void                    ReadFromSnapshot_Ex( const idBitMsg &msg );
  256.      virtual void            ReadFromSnapshot( const idBitMsg &msg );
  257.      virtual bool            ServerReceiveEvent( int event, int time, const idBitMsg &msg );
  258.      virtual bool            ClientReceiveEvent( int event, int time, const idBitMsg &msg );
  259.  
  260.      void                    WriteBindToSnapshot( idBitMsg &msg ) const;
  261.      void                    ReadBindFromSnapshot( const idBitMsg &msg );
  262.      void                    WriteColorToSnapshot( idBitMsg &msg ) const;
  263.      void                    ReadColorFromSnapshot( const idBitMsg &msg );
  264.      void                    WriteGUIToSnapshot( idBitMsg &msg ) const;
  265.      void                    ReadGUIFromSnapshot( const idBitMsg &msg );
  266.  
  267.      void                    ServerSendEvent( int eventId, const idBitMsg *msg, bool saveEvent, lobbyUserID_t excluding = lobbyUserID_t() ) const;
  268.      void                    ClientSendEvent( int eventId, const idBitMsg *msg ) const;
  269.  
  270.      void                    SetUseClientInterpolation( bool use ) { useClientInterpolation = use; }
  271.  
  272.      void                    SetSkipReplication( const bool skip ) { fl.skipReplication = skip; }
  273.      bool                    GetSkipReplication() const { return fl.skipReplication; }
  274.      bool                    IsReplicated() const { return  GetEntityNumber() < ENTITYNUM_FIRST_NON_REPLICATED; }
  275.  
  276.      void                    CreateDeltasFromOldOriginAndAxis( const idVec3 & oldOrigin, const idMat3 & oldAxis );
  277.      void                    DecayOriginAndAxisDelta();     uint32                    GetPredictedKey() { return predictionKey; }
  278.      void                    SetPredictedKey( uint32 key_ ) { predictionKey = key_; }
  279.  
  280.      void                    FlagNewSnapshot();
  281.  
  282.      idEntity*                GetTeamChain() { return teamChain; }
  283.  
  284.      // It is only safe to interpolate if this entity has received two snapshots.
  285.      enum interpolationBehavior_t {
  286.          USE_NO_INTERPOLATION,
  287.          USE_LATEST_SNAP_ONLY,
  288.          USE_INTERPOLATION
  289.      };
  290.  
  291.      interpolationBehavior_t GetInterpolationBehavior() const { return interpolationBehavior; }
  292.      unsigned int            GetNumSnapshotsReceived() const { return snapshotsReceived; }
  293.  
  294.  protected:
  295.      renderEntity_t           renderEntity;               // used to present a model to the renderer
  296.      int                        　modelDefHandle;          // handle to static renderer model
  297.      refSound_t                refSound;                   // used to present sound to the audio engine
  298.  
  299.      idVec3                    GetOriginDelta() const { return originDelta; }
  300.      idMat3                    GetAxisDelta() const { return axisDelta; }
  301.  
  302. private:
  303.     idPhysics_Static        defaultPhysicsObj;        // default physics object
  304.     idPhysics *       　　  physics;              　// physics used for this entity
  305.     idEntity *             bindMaster;             // entity bound to if unequal NULL
  306.     jointHandle_t          bindJoint;          　　// joint bound to if unequal　INVALID_JOINT
  307.     int                     bindBody;            　// body bound to if unequal -1
  308.     idEntity *             teamMaster;       　　  // master of the physics team
  309.     idEntity *             teamChain;             // next entity in physics team
  310.     bool                useClientInterpolation;     // disables interpolation for some objects (handy for weapon world models)
  311.      int              numPVSAreas;             // number of renderer areas the entity covers
  312.      int              PVSAreas[MAX_PVS_AREAS];   // numbers of the renderer areas the entity covers
  313.  
  314.      signalList_t *            signals;
  315.  
  316.      int                        mpGUIState;            // local cache to avoid systematic SetStateInt
  317.       uint32                    predictionKey;         // Unique key used to sync predicted ents (projectiles) in MP.
  318.       // Delta values that are set when the server or client disagree on where the render model should be. If this happens,
  319.      // they resolve it through DecayOriginAndAxisDelta()
  320.      idVec3                    originDelta;
  321.      idMat3                    axisDelta;
  322.  
  323.      interpolationBehavior_t    interpolationBehavior;
  324.       unsigned int            snapshotsReceived;
  325.  
  326. private:
  327.      void                    FixupLocalizedStrings();
  328.       bool                    DoDormantTests();                // dormant == on the active list, but out of PVS 
  329.  
  330.      // physics                             // initialize the default physics
  331.      void                    InitDefaultPhysics( const idVec3 &origin, const idMat3 &axis );                             // update visual position from the physics
  332.      void                    UpdateFromPhysics( bool moveBack );          // get physics timestep
  333.      virtual int                GetPhysicsTimeStep() const;
  334.  
  335.       // entity binding
  336.      bool                    InitBind( idEntity *master );        // initialize an entity binding
  337.      void                    FinishBind();                 // finish an entity binding
  338.      void                    RemoveBinds();            // deletes any entities bound to this object
  339.      void                    QuitTeam();                    // leave the current team
  340.  
  341.      void                    UpdatePVSAreas();
  342.  
  343.       // events
  344.      void                    Event_GetName();
  345.      void                    Event_SetName( const char *name );
  346.      void                    Event_FindTargets();
  347.      void                    Event_ActivateTargets( idEntity *activator );
  348.      void                    Event_NumTargets();
  349.      void                    Event_GetTarget( float index );
  350.      void                    Event_RandomTarget( const char *ignore );
  351.      void                    Event_Bind( idEntity *master );
  352.      void                    Event_BindPosition( idEntity *master );
  353.      void                    Event_BindToJoint( idEntity *master, const char *jointname, float orientated );
  354.      void                    Event_Unbind();
  355.      void                    Event_RemoveBinds();
  356.      void                    Event_SpawnBind();
  357.      void                    Event_SetOwner( idEntity *owner );
  358.      void                    Event_SetModel( const char *modelname );
  359.      void                    Event_SetSkin( const char *skinname );
  360.      void                    Event_GetShaderParm( int parmnum );
  361.      void                    Event_SetShaderParm( int parmnum, float value );
  362.      void                    Event_SetShaderParms( float parm0, float parm1, float parm2, float parm3 );
  363.      void                    Event_SetColor( float red, float green, float blue );
  364.      void                    Event_GetColor();
  365.      void                    Event_IsHidden();
  366.      void                    Event_Hide();
  367.      void                    Event_Show();
  368.      void                    Event_CacheSoundShader( const char *soundName );
  369.      void                    Event_StartSoundShader( const char *soundName, int channel );
  370.      void                    Event_StopSound( int channel, int netSync );
  371.      void                    Event_StartSound( const char *soundName, int channel, int netSync );
  372.      void                    Event_FadeSound( int channel, float to, float over );
  373.      void                    Event_GetWorldOrigin();
  374.      void                    Event_SetWorldOrigin( idVec3 const &org );
  375.      void                    Event_GetOrigin();
  376.      void                    Event_SetOrigin( const idVec3 &org );
  377.      void                    Event_GetAngles();
  378.      void                    Event_SetAngles( const idAngles &ang );
  379.      void                    Event_SetLinearVelocity( const idVec3 &velocity );
  380.      void                    Event_GetLinearVelocity();
  381.      void                    Event_SetAngularVelocity( const idVec3 &velocity );
  382.      void                    Event_GetAngularVelocity();
  383.      void                    Event_SetSize( const idVec3 &mins, const idVec3 &maxs );
  384.      void                    Event_GetSize();
  385.      void                    Event_GetMins();
  386.      void                    Event_GetMaxs();
  387.      void                    Event_Touches( idEntity *ent );
  388.      void                    Event_SetGuiParm( const char *key, const char *val );
  389.      void                    Event_SetGuiFloat( const char *key, float f );
  390.      void                    Event_GetNextKey( const char *prefix, const char *lastMatch );
  391.      void                    Event_SetKey( const char *key, const char *value );
  392.      void                    Event_GetKey( const char *key );
  393.      void                    Event_GetIntKey( const char *key );
  394.      void                    Event_GetFloatKey( const char *key );
  395.      void                    Event_GetVectorKey( const char *key );
  396.      void                    Event_GetEntityKey( const char *key );
  397.      void                    Event_RestorePosition();
  398.      void                    Event_UpdateCameraTarget();
  399.      void                    Event_DistanceTo( idEntity *ent );
  400.      void                    Event_DistanceToPoint( const idVec3 &point );
  401.      void                    Event_StartFx( const char *fx );
  402.      void                    Event_WaitFrame();
  403.      void                    Event_Wait( float time );
  404.      void                    Event_HasFunction( const char *name );
  405.      void                    Event_CallFunction( const char *name );
  406.      void                    Event_SetNeverDormant( int enable );
  407.      void                    Event_SetGui( int guiNum, const char *guiName);
  408.      void                    Event_PrecacheGui( const char *guiName );
  409.      void                    Event_GetGuiParm(int guiNum, const char *key);
  410.      void                    Event_GetGuiParmFloat(int guiNum, const char *key);
  411.      void                    Event_GuiNamedEvent(int guiNum, const char *event); };

つまり、言いたいのは、コードが長いということです。Physics debrisに至るまでの全てのエンティティにチームという概念があり、殺されてしまうと概念があります。あきらかに理想的とは言えません。

もし、Unityのゲーム開発者なら解決策はお分かりでしょう。コンポーネントです。次のようになります。


Unityのオブジェクトは、機能の継承ではなくコンポーネントのまとまりなのです。これで、先ほどの砲塔の問題を簡単に解決できます。砲塔のコンポーネントをプレーヤーと車のオブジェクトに追加すれば良いのです。

Doom 3にコンポーネントを使用した場合、次のようなコードになります。

  1. idPlayer
  2.      idTransform
  3.      idHealth
  4.      idAnimatedModel
  5.      idAnimator
  6.      idRigidBody
  7.      idBipedalCharacterController
  8.      idPlayerController
  9. idAFEntity_VehicleFourWheels
  10.      idTransform
  11.      idAnimatedModel
  12.      idRigidBody
  13.      idFourWheelController
  14. ...

ここまででわかることとは何でしょうか。

策略その3：概して継承よりコンポジションを好むべし

ここまでの策略を振り返ってみると、グローバル変数はダメ、オブジェクトはいい、コンポーネントはさらにいいとの結果がでました。次に説明することは信じ難いかもしれません。

ちょっとだけ脱線して、どの関数がより速いのかというとても簡単な質問を手掛かりに下層階のパフォーマンスの世界をのぞいてみましょう。

  1. double a(double x) 
  2. {
  3.     return Math.sqrt(x); 
  4. }
  5.  
  6. static double[] data; 
  7. double b(int x) 
  8. {
  9.     return data[x]; 
  10. }

多くの複雑性はひとまず忘れて、これら2つの関数がいずれ、それぞれ1つのx86命令にコンパイルされると仮定します。恐らく、関数aはsqrtpsにコンパイルされ、関数bはlea(「load effective address」命令)のようなものにコンパイルされるでしょう。

インテルマニュアルによると、sqrtps命令には、最新のインテルプロセッサでおよそ14CPUサイクルが浪費されます。では、lea命令はどうでしょうか。

答えは、「それは複雑な問題」ということになります。データの書き込みがどこから実行されるかによって変わってくるのです。

レジスタ 1コア当たり最高40本（だいたい） 0サイクル
L1 1コア当たり32KB 64B行 4サイクル
L2 1コア当たり256KB 64B行 11サイクル
L3 6MB 64B行 40-75サイクル
メインメモリ 8GB 4KBページ 100-300 サイクル

最後の数字が重要なのです。メインメモリにアクセスするのに100-300サイクル浪費するのです。つまり、どのような時でも、障害となるのは、メモリへのアクセスになるということでしょう。見て分かるように、L1やL2、L3のキャッシュの使用を増やせばこの状況を改善することができます。でもどのようにすれば良いのでしょうか。

では、Doom 3に戻って現実的な例を挙げてみましょう。次は、Doom 3のアップデートループです。

  1. for ( idEntity* ent = activeEntities.Next(); 
  2.     ent != NULL; 
  3.     ent = ent->activeNode.Next() ) 
  4. {
  5.     if ( g_cinematic.GetBool() && inCinematic && !ent->cinematic ) 
  6.     {
  7.         ent->GetPhysics()->UpdateTime( time ); 
  8.         continue; 
  9.     }
  10.     timer_singlethink.Clear(); 
  11.     timer_singlethink.Start(); 
  12.     RunEntityThink( *ent, cmdMgr ); 
  13.     timer_singlethink.Stop(); 
  14.     ms = timer_singlethink.Milliseconds(); 
  15.     if ( ms >= g_timeentities.GetFloat() ) 
  16.         Printf( "%d: entity '%s': %.1f ms\n", time, ent->name.c_str(), ms );
  17.      num++; 
  18. }

オブジェクト指向の観点からすると、このコードはきれいで汎用性があります。多分RunEntityThinkが仮想のThink()メソッドを呼び出すことで、ほとんどのことができるのだろうと思います。とても応用がきくと思います。

おっと、ボスがまた戻ってきました。質問があるようです。

  • 実行とは何？　どのオブジェクトがアクティブなのかによって答えは変わってきます。なので、正確には分かりません。

  • 実行の順番は？　見当がつきません。ゲームをしている際に、オブジェクトがリストに追加されたり削除されたりします。

  • 並行処理にするには？　難しいです。オブジェクトは不規則に実行されるので、オブジェクト同士で互いのステートにアクセスしているのかもしれません。スレッドの間で分割してしまうと、何が起きるか予測できません。

簡単に言うと次のとおりです。


しかし、これだけではありません。よく見てみると、オブジェクトはリンクされたリストに格納されています。メモリ内では、次のようになっています。


これではL1やL2、L3のキャッシュが残念なことになっています。リストの最初のアイテムにアクセスするとキャッシュは、「次に欲しいのは近くのアイテムだ」と思います。そして、最初のアクセスが終わると、次の64バイトを引っ張ってきます。しかしその直後、全く別のメモリ領域へと飛ぶため、キャッシュは使おうとした64バイトをクリアし、RAMにある新データにアクセスします。

策略その4：メモリ内のデータを整列させるとパフォーマンスが大幅に向上する

こんな感じです。

  1. for (int i = 0; i < rigid_bodies.length; i++)
  2.     rigid_bodies[i].update();
  3.  
  4. for (int i = 0; i < ai_controllers.length; i++)
  5.     ai_controllers[i].update();
  6.  
  7. for (int i = 0; i < animated_models.length; i++)
  8.     animated_models[i].update();
  9.  
  10. // ...

オブジェクト指向のプログラマは、このコードに怒りを覚えるかもしれません。汎用性が全然足りないからです。ご覧の通り、隣接している配列に対して同じ処理を繰り返し実行しています（ポインタの配列ではありません、念のため）。従って、メモリの中身はこのようになります。


全てが順番に並んでいます。キャッシュは大満足です。おまけに、このバージョンを使えば、ボスから投げかけられた煩わしい質問に、全部答えることができます。今なら私たちは、実行とはどういうことか、どの順番で実行しているかが分かっていますし、並行処理に書き換えるのもずっとやりやすくなったように見えます。

追記：キャッシュの最適化に熱中しすぎないように気を付けてください。最適化は、全てを配列に配置すれば終わりというわけではありません。本稿でこの処理を取り上げたのは、要点の裏付けとするためですが、私の力では、初歩の導入部分を説明することぐらいしかできません。詳細は本稿の最後に示すリンク先を参照してください。

ではそろそろまとめに入ります。究極の奇策とは何でしょう。策略その1からその4（本当はまだまだ続きがあります）の共通点とは何でしょう。

究極の奇策：コードではなくデータを先に

グローバル変数を悪だと考える根拠は何でしょう（策略その1）？　ずぼらなデータ設計でもどうにかごまかせるからです。

オブジェクトはなぜ便利なのでしょう（策略その2）？　データの整理がやりやすくなるからです。

コンポーネントがさらに便利なのはなぜでしょう（策略その3）？　コンポーネントはデータをうまくモデル化していて、現実のデータ構造と調和しやすくなっているからです。

また、データをきちんと整理すればCPUにも喜んでもらえます（策略その4）。

あまりピンと来ないんだけど、策略って例えばどんなもの？

では実例を示しながら説明します。Unityでよく見られる、コンポーネントベースのゲームデザインの例を示します。

1つのコンポーネントが1つのオブジェクトになっています。オブジェクトの中では、上の方にステート変数が列挙されていて、その下に、その変数を使うメソッドが挙げられています。

これはよく練られたデザインの、オブジェクト指向のシステムなので、変数はプライベート変数です。変数にアクセスできるコードは、そのオブジェクト内のメソッドだけです。これを「カプセル化」と言います。

オブジェクトにはそれぞれ、ある程度の複雑性が含まれます。でも恐れることはありません。OOP（オブジェクト指向プログラミング）の世界では、変数のステートをプライベートにしておく限り、複雑性はオブジェクト内にカプセル化されたままで、他のオブジェクトに拡散することはないというのがお約束です。

しかし残念ながら、これは真実ではありません。


訳：お前が座っているのは嘘で固められた玉座だ

2～3個のオブジェクトにアクセスする関数が必要になることが、往々にしてあります。こういう場合、現実的な解決策は次の2つのうちのどちらかです。1つは、あくまでオブジェクト内で完結するように、関数の方を分割する方法です。もう1つは「getなんとか」「setなんとか」のような関数を山ほど書いて、必要なデータにアクセスする方法です。ただし、どちらのソリューションもあまり感心しません。

ここからが真実です。オブジェクトとして表そうとするとあまりうまくいかないものごとが、現実には存在します。そこで私はオブジェクトに代わるパラダイムを提案します。どんなプログラムでも完璧に表現できるパラダイムです。


訳注：入力データ→プロセス→出力データ

データをプロセスから切り離せば、がぜん分かりやすくなります。

オブジェクト指向には、美しいコードを書きやすいという利点があります。複雑性（つまりステート）はカプセル化するという決まりがあるからです。一方、カプセル化には特定の処理方法しか許されない、という性質もあります。以下の図のようなカプセル化が認められてもいいと私は思います。こうすれば問題が起こった現場では、ちゃんと筋が通るのですから。

まとめると、データ構造の設計は、あなたが直面している問題に即した形にすることが大事です。1つのコンセプトを幾つにも分割して、カプセル化したオブジェクトに押し込んではいけません。

それから、関数を書く時は、使用するデータに残すフットプリントをできるだけ小さくします。可能であれば、純粋にステートレスな関数を書いてください。

これが策略です。

結論

本稿に共感できたとすれば、それは私がほとんど以下の文献に頼ってこれを書いたからでしょう。その文献を正直に紹介します。

最後まで読んでくださってありがとうございました。感想があればぜひコメント欄に書き込んでください。

Next Post

Previous Post