[PloobsEngine] Tutorial 5 – Initialization Parameters


This tutorial will talk about the PloobsEngine Initialization Parameters. (tutorials series here)

The tutorials so far used some “curious” options when initializing the engine, now we will talk about each of those misterious choices. =P

In every engine sample, we have the following block of the code (when starting the engine).

            InitialEngineDescription desc = InitialEngineDescription.Default();
            ///start the engine
            using (EngineStuff engine = new EngineStuff(ref desc, LoadScreen))
            {
                engine.Run();
            }

We are just creating a simple object describing the engine initialization confs, providing it to the EngineStuff constructor and starting the PloobsEngine workflow.

Now we will talk about the InitialEngineDescription object in depth.

We can create the InitialEngineDescription using the static method Default or using the detained constructor. The following block discuss a little about the parameters you can change in this object.

  • BackBufferHeight: the resolution of the screen in Y (if windowed also controls the Y size of the screen)
  • BackBufferWidth: the resolution of the screen in X (if windowed also controls the X size of the screen)
  • isFullScreen: If true, the game will run in fullscreen mode, if not, windowed.
  • GraphicsProfile: The engine only support HiDef profile in this release. We plan to use this field to load in run time the right DLL for the users.
  • isFixedGameTime: If true, the engine will force the game to be 60 FPS (and will try to ensure the game has this minimum FPS, if it is slower than this, the draw method  will be called less times). When debuggingm i suggest to turn this off (so the FPS will be real).
  • isMultiSampling: to use force using Multisampling  (Anti Aliasing method). This ONLY works in Forward Rendering. If you enable this in deferred we will use Multisampling but the quality wont be improved a lot (cause under XNA (DirectX 9c) we dont have Multisample when using Multiple Render Targets). We suggest to turn this off in lower specs PCs when Deferred Render is used. Under Deferred Render, try using Post effects AA technichs (will be explained in next tutorials =P)
  • Logger: Interface provided by the user (can be null) where the engine logs problems (will be discussed more later in this article)
  • OnExit: Event called when the engine exits
  • ScreenName: The name you want to the engine screen
  • UnhandledException_Handlerquality
  • UseAnisotropicFiltering: Use Anisotropic Filtering instead of Linear filtering when possible (better quality but slower)
  • useMipMapWhenPossible: Improve Texture filtering using MipMaps when possible (better quality but slower)
  • UseVerticalSyncronization: Sync the graphics drawing with the monitor refresj frequency (recomended, but forces the draw FPS to 60)

Engine Default

When you call the static method Default of the the InitialEngineDescription, the following options are used:

public InitialEngineDescription(string ScreenName = "PloobsEngine", int BackBufferWidth = 800, int BackBufferHeight = 600, bool isFullScreen = false, GraphicsProfile graphicsProfile = GraphicsProfile.HiDef, bool useVerticalSyncronization = false, bool isMultiSampling = false, bool isFixedGameTime = false, ILogger logger = null, bool useMipMapWhenPossible = false, bool UseAnisotropicFiltering = false);

ILogger

The PloobsEngine Debug DLL (the one provided) sometimes logs messages to the user. These messages can be:

  • Warnings: Whe the user does something that is not wrong, but normally is not what “user wants” to do. The message is just a “Are you sure you want to do this ???”
  • Recoverable Errors: When the user make a error somewhere, but the engine can recover from it (THE USER SHOULD correct the source of the problem), normally the engine aborts the current operation when recoverable  errors happens, ao unexpected stuffs can happen.
  • Fatal Error: This happens when the user does something that CANNOT be done. This is normally folowed by an Exception being thrown.

The user can provide a implementation of the interface ILogger to the InitialEngineDescription object (if not provided, nothing is logged … we STRONGLY recomend implementing this). The following code show the interface:

public interface ILogger
    {
        void Log(string Message, LogLevel logLevel);
    }

It is pretty simple, you override the Log method. The LogLevel can be Warning, Fatal Error and Recoverable Error as dicussed. We tried to not use the ILogger in code that runs everytime, so you can write to files, write to server … in the implementation (we suggest you to dont do this in production code, try to use Threads or something assync to proccess the message).In debug a simple Debug.WriteLine is enough =P

Users can also log messager using this log system. Just use the following static method: (everywhere, after the EngineStuff constructor)

PloobsEngine.Engine.Logger.ActiveLogger.LogMessage(message,PloobsEngine.Engine.Logger.LogLevel.LOGLEVEL_YOU_WANT);

Unhandled Exception

Sometimes, the engine can throw exeptions to the user (When fatal error happens (user mistake),when XNA/Windows fails, when engine bugs decide to appear =P … ). The engine normally does catch those exception, so the user can handle them (you cant recover, your job is to “something” like write to a log file or server, before the end the of the execution). To use this funcionality, you just need to provide a method with the following signature to the InitialEngineDescription.

public delegate void UnhandledException(object sender, UnhandledExceptionEventArgs e);

Its all for today (small tutorial =P)

Any doubts, critics, suggestions, pls go to our forum or leave a comment here.

See you guys =P

Links

 

, , , ,

  1. #1 by Teodoro on 22 de junho de 2017 - 11:53 am

    Trim the feathers from the underside in order that the central backbone of the feathers is
    seen.

  2. #2 by Young Jarquin on 22 de junho de 2017 - 11:56 am

    I would like to share my amazing experience with you guys because the rent to own program did help me and my husband at huge huge time because of our first successful homeowners quickly.

  3. #3 by agen bandarq on 22 de junho de 2017 - 12:18 pm

    Hiya, I’m really glad I’ve found this info. Today bloggers publish only about gossip and internet stuff and this is really irritating. A good website with interesting content, this is what I need. Thanks for making this website, and I’ll be visiting again. Do you do newsletters by email?

  4. #4 by Raphael on 22 de junho de 2017 - 12:23 pm

    I don’t normally comment but I gotta say regards for the post on this one
    :D.

  5. #5 by match.com on 22 de junho de 2017 - 12:52 pm

    Wonderful Web-site, Stick to the useful job. Thanks a lot!

  6. #6 by Danon Jewellery on 22 de junho de 2017 - 1:04 pm

    She as soon as worked on a cosmetics counter so in all probability is
    aware of a bit more about what she wished than some others.

  7. #7 by curved 4k tv on 22 de junho de 2017 - 1:13 pm

    Thank you for any other informative site. The place else may I am getting that type of information written in such an ideal way?

    I’ve a project that I am simply now working on, and I have been at the glance out
    for such information.

  8. #8 by jewellery kalyan on 22 de junho de 2017 - 1:13 pm

    He says this only occurs in a number of per cent of jewellery
    claims and isn’t unfair as a result of some people don’t need a new replacement, anyway.

  9. #9 by jaipur escort on 22 de junho de 2017 - 1:20 pm

    Amazing issues here. I am very glad to peer your article.
    Thanks a lot and I am having a look forward to contact you.
    Will you please drop me a e-mail?

  10. #10 by Bell on 22 de junho de 2017 - 1:22 pm

    Precious stones belong to Navratna household in accordance
    with Indian gemology.

  11. #11 by lace frontal on 22 de junho de 2017 - 1:27 pm

    I purchased these lace frontal https://www.youtube.com/watch?v=ny8rUpI_98I final drop and provide them nearly everyday! I cherished them ; how cute they seemed over ! I absolutely will be buying these all over again this year!

  12. #12 by sociale-controle.nl review on 22 de junho de 2017 - 1:37 pm

    I pay a visit everyday a few sites and sites to read articles, except this webpage presents quality based content.

  13. #13 by ninja sword for sale on 22 de junho de 2017 - 1:48 pm

    Thes Katanas were purchased as gifts for employees and were very good quality. The employees were surprised by the weight and sturdy feel of the swords. I will all by cold steel from now one.

  14. #14 by match.com on 22 de junho de 2017 - 1:52 pm

    Excellent Webpage, Carry on the useful job. Thanks.

  15. #15 by institut massage lyon on 22 de junho de 2017 - 1:59 pm

    Nice answers in return of this matter with
    real arguments and describing everything on the topic of that. https://goo.gl/maps/RLPFGxUQTms

  16. #16 by Friv5 on 22 de junho de 2017 - 2:01 pm

    Hi this is somewhat of off topic but I was wondering if blogs use WYSIWYG editors or if you have to manually code
    with HTML. I’m starting a blog soon but have
    no coding skills so I wanted to get guidance from someone with experience.
    Any help would be greatly appreciated!

  17. #17 by Gladis on 22 de junho de 2017 - 2:21 pm

    This is largely all the way down to how the designers have utilised small particulars
    reminiscent of stars and hearts to embellish their jewelry designs.

  18. #18 by gas grill on 22 de junho de 2017 - 2:51 pm

    Now I am ready to do my breakfast, once having my breakfast coming again to
    read additional news.

  19. #19 by Michal on 22 de junho de 2017 - 3:14 pm

    Proceed doing good⦠I like the best way
    you write⦠Thumbs up!

  20. #20 by Franklyn on 22 de junho de 2017 - 3:18 pm

    136 S. eighth Road Phil.

  21. #21 by website on 22 de junho de 2017 - 3:29 pm

    There are voice activated recorders, little cameras, and even GPS devices out there.
    They offer features like Two Wash Courses (Gentle &
    Normal Wash, twin water inlets, spin shower, two wash courses
    (Gentle and Normal wash), and wheels for easy
    mobility in some models. Do you suspect that your employee is performing something mistaken with your
    enterprise.

  22. #22 by Patricia on 22 de junho de 2017 - 3:30 pm

    Excellent post. I’m going through a few of these
    issues as well..

  23. #23 by startseite on 22 de junho de 2017 - 3:30 pm

    Die besten Sexseiten über Schuhfick Pornos über High Heels sexy nur für Dich.

  24. #24 by Situs Judi Poker Online Terpercaya on 22 de junho de 2017 - 3:34 pm

    You could definitely see your expertise within the work you write.
    The sector hopes for even more passionate writers like
    you who aren’t afraid to say how they believe.
    Always go after your heart.

  25. #25 by katies on 22 de junho de 2017 - 3:37 pm

    diet pills of the 1970s history decade

  26. #26 by www.youtube.com on 22 de junho de 2017 - 3:45 pm

    Hello! I know this is somewhat off topic but
    I was wondering if you knew where I could get a captcha plugin for my comment
    form? I’m using the same blog platform as yours and I’m having
    trouble finding one? Thanks a lot!

  27. #28 by facebook login on 22 de junho de 2017 - 4:03 pm

    Set the crowd selector on each album to regulate access for a photographs.

    Selling your real estate can be an alluring concept
    due towards the premiums given to property agents and firms.

  28. #29 by Amazon Prime Support on 22 de junho de 2017 - 4:04 pm

    You can certainly see your enthusiasm in the article you write.
    The world hopes for more passionate writers such as you who are not afraid to say how they believe.
    All the time follow your heart.

  29. #30 by Blanchiment dentaire on 22 de junho de 2017 - 4:14 pm

    Blanchir ses Dents : Le blanchiment des dents est très en vogue car de plus en plus de monde souhaitent avoir un beau sourire.
    Pensez aux techniques de blanchiment des dents pour vous rendre un beau sourire tout blanc.
    Blanchiment dentaire professionnel avec le centre de cabinet
    dentaire à Paris : https://dentaire-paris-13.fr/content/blanchiment-des-dents-paris-13%C3%A8me-75-pierre-martin

  30. #32 by Tinder pour PC on 22 de junho de 2017 - 4:22 pm

    Definitely imagine that that you said. Your favourite justification appeared to be at the web the simplest
    thing to understand of. I say to you, I definitely get annoyed whilst people think
    about worries that they plainly don’t understand about. You managed to hit the
    nail upon the top as neatly as outlined out the whole thing without
    having side effect , people can take a signal. Will likely be back to get more.
    Thank you

  31. #33 by led shoes on 22 de junho de 2017 - 4:31 pm

    I must express thanks to you just for bailing me out of this type of predicament. As a result of looking out throughout the world-wide-web and seeing opinions which were not beneficial, I thought my entire life was done. Living without the solutions to the issues you have resolved by means of the article is a critical case, and ones which could have in a wrong way damaged my entire career if I had not discovered your web page. Your good skills and kindness in dealing with everything was crucial. I don’t know what I would have done if I hadn’t come upon such a point like this. It’s possible to at this moment look forward to my future. Thanks a lot so much for the high quality and effective guide. I won’t think twice to propose your blog post to anyone who ought to have guidance on this area.

  32. #34 by https://creativeku.com/ on 22 de junho de 2017 - 4:51 pm

    In general, the top techniques involve getting outside of yourself and having the
    girl to discuss her interests. Sixth, whenever a guy shows interest
    in you, he’ll find a conversation along while requesting
    your reputation and speak to too. But truth being told, this can be one of many hardest location to achieve this because usually they
    already know that what you are attempting to do and also have their guard up.

  33. #35 by web page on 22 de junho de 2017 - 5:13 pm

    With this Blackberry spy software you will not
    be left in the dark. Taking the computer repair specialist route also has its ups and downs, but perhaps more advantages than disadvantages.
    Right after all, it really is your corporation that feeds and outfits your relatives
    and puts a ceiling over their mind.

  34. #36 by Essay on 22 de junho de 2017 - 5:49 pm

    He said he tried to train Dipont guidance counselors
    to help students come up with their own essay ideas, but struggled.
    Some topics are very lengthy and sophisticated and
    may be time consuming when you are putting a essay collectively.
    The challenge this field has requires great discipline, and necessitates a goal-oriented approach, and I am a goal-oriented individual who
    is attracted to the step-by-step progression involved in making a career
    as a Professional Chiropractor.

  35. #37 by Жалюзи электрические наружные цены on 22 de junho de 2017 - 5:51 pm

    At the time, Lampert believed in the long-term
    success of Sears, according to the executive. Call before your
    order and speak to a customer service representative.
    Vertical window blinds are a great choice for certain rooms in your home, including the bedroom, living room and kitchen, as they provide great versatility and control with pleasing aesthetic design.

  36. #38 by https://docs.google.com on 22 de junho de 2017 - 6:05 pm

    Right away I am going to do my breakfast, later than having my breakfast coming
    over again to read further news.

  37. #39 by katie on 22 de junho de 2017 - 6:26 pm

    ephedra diet pills 50mg anavar a day

  38. #40 by cleaning authority san antonio on 22 de junho de 2017 - 6:39 pm

    ASRC Cleaning has the capacity to clean offices, schools, churches, commercial and retail spaces across Melbourne.

  39. #41 by nha trang on 22 de junho de 2017 - 6:44 pm

    Hello! I know this is kinda off topic however I’d figured I’d ask.
    Would you be interested in exchanging links or maybe guest writing a blog article or vice-versa?
    My blog discusses a lot of the same topics as yours and I believe we could greatly
    benefit from each other. If you happen to be interested feel free to shoot me an email.

    I look forward to hearing from you! Wonderful blog by the way!

  40. #42 by top trumps celebs on 22 de junho de 2017 - 6:48 pm

    TҺanks foг tҺe marvelous posting! І actuaⅼly enjoyed reading іt,
    үoᥙ migҺt be a great author. I willl remember
    to bookmark ʏour blog and may come back sometіme soon. I wаnt
    to encourage yoս tߋ ultimately continue your ցreat job, haᴠe a nice afternoon!

  41. #43 by match.com on 22 de junho de 2017 - 6:57 pm

    Amazing Web page, Stick to the good job. thnx!

  42. #44 by Mariam on 22 de junho de 2017 - 7:09 pm

    you are truly a good webmaster. The website loading pace
    is amazing. It kind of feels that you’re doing any unique
    trick. Furthermore, The contents are masterwork.

    you have done a great job on this subject!

  43. #45 by licensed plumber on 22 de junho de 2017 - 7:10 pm

    here are some hyperlinks to web sites that we link to due to the fact we think they may be worth visiting

1 1.740 1.741 1.742
(não será publicado)