code: protected boolean insertMedia (AbstractMedia media)
      {
          if (_media.contains(media)) {
              log.warning("Attempt to insert media more than once [media=" + media + "].",
                          new Exception());
              return false;
          }
  
          media.init(this);
          int ipos = _media.insertSorted(media, RENDER_ORDER);
  
          // if we've started our tick but have not yet painted our media, we need to take care that
          // this newly added media will be ticked before our upcoming render
          if (_tickStamp > 0L) {
              if (_tickpos == -1) {
                  // if we're done with our own call to tick(), we need to tick this new media
                  tickMedia(media, _tickStamp);
              } else if (ipos <= _tickpos) {
                  // otherwise, we're in the middle of our call to tick() and we only need to tick
                  // this guy if he's being inserted before our current tick position (if he's
                  // inserted after our current position, we'll get to him as part of this tick
                  // iteration)
                  _tickpos++;
                  tickMedia(media, _tickStamp);
              }
          }
  
          return true;
      }
docs: Inserts the specified media into this manager, return true on success.