chore: Add comments explaining why we skip display object initializer calls

Author: Lord-McSweeney

core/src/display_object/morph_shape.rs

@@ -119,6 +119,9 @@ impl<'gc> TDisplayObject<'gc> for MorphShape<'gc> {
         if self.movie().is_action_script_3() && matches!(self.object2(), Avm2Value::Null) {
             let class = context.avm2.classes().morphshape;
             let object = Avm2StageObject::for_display_object(context.gc(), self.into(), class);
+            // We don't need to call the initializer method, as AVM2 can't link
+            // a custom class to a MorphShape, and the initializer method for
+            // MorphShape itself is a no-op
             self.set_object2(context, object.into());
 
             self.on_construction_complete(context);

core/src/display_object/stage.rs

@@ -766,7 +766,7 @@ impl<'gc> TDisplayObject<'gc> for Stage<'gc> {
 
         // TODO: Replace this when we have a convenience method for constructing AVM2 native objects.
         // TODO: We should only do this if the movie is actually an AVM2 movie.
-        // This is necessary for EventDispatcher super-constructor to run.
+        // This is necessary for DisplayObject and EventDispatcher super-constructors to run.
         let global_domain = context.avm2.stage_domain();
         let mut activation = Avm2Activation::from_domain(context, global_domain);
         let avm2_stage = Avm2StageObject::for_display_object_childless(

core/src/display_object/text.rs

@@ -272,6 +272,9 @@ impl<'gc> TDisplayObject<'gc> for Text<'gc> {
         if self.movie().is_action_script_3() {
             let statictext = context.avm2.classes().statictext;
             let object = Avm2StageObject::for_display_object(context.gc(), self.into(), statictext);
+            // We don't need to call the initializer method, as AVM2 can't link
+            // a custom class to a StaticText, and the initializer method for
+            // StaticText itself is a no-op
             self.set_object2(context, object.into());
 
             self.on_construction_complete(context);

core/src/display_object/video.rs

@@ -451,6 +451,10 @@ impl<'gc> TDisplayObject<'gc> for Video<'gc> {
             let video_constr = context.avm2.classes().video;
             let object =
                 Avm2StageObject::for_display_object(context.gc(), self.into(), video_constr);
+            // We don't need to call the initializer method, as AVM2 can't link
+            // a custom class to a Video, and the initializer method for Video
+            // itself only sets the size of the Video- the Video already has the
+            // correct size at this point.
 
             self.set_object2(context, object.into());