12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425342634273428342934303431343234333434343534363437343834393440344134423443344434453446344734483449345034513452345334543455345634573458345934603461346234633464346534663467346834693470347134723473347434753476347734783479348034813482348334843485348634873488348934903491349234933494349534963497349834993500350135023503350435053506350735083509351035113512351335143515351635173518351935203521352235233524352535263527352835293530353135323533353435353536353735383539354035413542354335443545354635473548354935503551355235533554355535563557355835593560356135623563356435653566356735683569357035713572357335743575357635773578357935803581358235833584358535863587358835893590359135923593359435953596359735983599360036013602360336043605360636073608360936103611361236133614361536163617361836193620362136223623362436253626362736283629363036313632363336343635363636373638363936403641364236433644364536463647364836493650365136523653365436553656365736583659366036613662366336643665366636673668366936703671367236733674367536763677367836793680368136823683368436853686368736883689369036913692369336943695369636973698369937003701370237033704370537063707370837093710371137123713371437153716371737183719372037213722372337243725372637273728372937303731373237333734373537363737373837393740374137423743374437453746374737483749375037513752375337543755375637573758375937603761376237633764376537663767376837693770377137723773377437753776377737783779378037813782378337843785378637873788378937903791379237933794379537963797379837993800380138023803380438053806380738083809381038113812381338143815381638173818381938203821382238233824382538263827382838293830383138323833383438353836383738383839384038413842384338443845384638473848384938503851385238533854385538563857385838593860386138623863386438653866386738683869387038713872387338743875387638773878387938803881388238833884388538863887388838893890389138923893389438953896389738983899390039013902390339043905390639073908390939103911391239133914391539163917391839193920392139223923392439253926392739283929393039313932393339343935393639373938393939403941394239433944394539463947394839493950395139523953395439553956395739583959396039613962396339643965396639673968396939703971397239733974397539763977397839793980398139823983398439853986398739883989399039913992399339943995399639973998399940004001400240034004400540064007400840094010401140124013401440154016401740184019402040214022402340244025402640274028402940304031403240334034403540364037403840394040404140424043404440454046404740484049405040514052405340544055405640574058405940604061406240634064406540664067406840694070407140724073407440754076407740784079408040814082408340844085408640874088408940904091409240934094409540964097409840994100410141024103410441054106410741084109411041114112411341144115411641174118411941204121412241234124412541264127412841294130413141324133413441354136413741384139414041414142414341444145414641474148414941504151415241534154415541564157415841594160416141624163416441654166416741684169417041714172417341744175417641774178417941804181418241834184418541864187418841894190419141924193419441954196419741984199420042014202420342044205420642074208420942104211421242134214421542164217421842194220422142224223422442254226422742284229423042314232423342344235423642374238423942404241424242434244424542464247424842494250425142524253425442554256425742584259426042614262426342644265426642674268426942704271427242734274427542764277427842794280428142824283428442854286428742884289429042914292429342944295429642974298429943004301430243034304430543064307430843094310431143124313431443154316431743184319432043214322432343244325432643274328432943304331433243334334433543364337433843394340434143424343434443454346434743484349435043514352435343544355435643574358435943604361436243634364436543664367436843694370437143724373437443754376437743784379438043814382438343844385438643874388438943904391439243934394439543964397439843994400440144024403440444054406440744084409441044114412441344144415441644174418441944204421442244234424442544264427442844294430443144324433443444354436443744384439444044414442444344444445444644474448444944504451445244534454445544564457445844594460446144624463446444654466446744684469447044714472447344744475447644774478447944804481448244834484448544864487448844894490449144924493449444954496449744984499450045014502450345044505450645074508450945104511451245134514451545164517451845194520452145224523452445254526452745284529453045314532453345344535453645374538453945404541454245434544454545464547454845494550455145524553455445554556455745584559456045614562456345644565456645674568456945704571457245734574457545764577457845794580458145824583458445854586458745884589459045914592459345944595459645974598459946004601460246034604460546064607460846094610461146124613461446154616461746184619462046214622462346244625462646274628462946304631463246334634463546364637463846394640464146424643464446454646464746484649465046514652465346544655465646574658465946604661466246634664466546664667466846694670467146724673467446754676467746784679468046814682468346844685468646874688468946904691469246934694469546964697469846994700470147024703470447054706470747084709471047114712471347144715471647174718471947204721472247234724472547264727472847294730473147324733473447354736473747384739474047414742474347444745474647474748474947504751475247534754475547564757475847594760476147624763476447654766476747684769477047714772477347744775477647774778477947804781478247834784478547864787478847894790479147924793479447954796479747984799480048014802480348044805480648074808480948104811481248134814481548164817481848194820482148224823482448254826482748284829483048314832483348344835483648374838483948404841484248434844484548464847484848494850485148524853485448554856485748584859486048614862486348644865486648674868486948704871487248734874487548764877487848794880488148824883488448854886488748884889489048914892489348944895489648974898489949004901490249034904490549064907490849094910491149124913491449154916491749184919492049214922492349244925492649274928492949304931493249334934493549364937493849394940494149424943494449454946494749484949495049514952495349544955495649574958495949604961496249634964496549664967496849694970497149724973497449754976497749784979498049814982498349844985498649874988498949904991499249934994499549964997499849995000500150025003500450055006500750085009501050115012501350145015501650175018501950205021502250235024502550265027502850295030503150325033503450355036503750385039504050415042504350445045504650475048504950505051505250535054505550565057505850595060506150625063506450655066506750685069507050715072507350745075507650775078507950805081508250835084508550865087508850895090509150925093509450955096509750985099510051015102510351045105510651075108510951105111511251135114511551165117511851195120512151225123512451255126512751285129513051315132513351345135513651375138513951405141514251435144514551465147514851495150515151525153515451555156515751585159516051615162516351645165516651675168516951705171517251735174517551765177517851795180518151825183518451855186518751885189519051915192519351945195519651975198519952005201520252035204520552065207520852095210521152125213521452155216521752185219522052215222522352245225522652275228522952305231523252335234523552365237523852395240524152425243524452455246524752485249525052515252525352545255525652575258525952605261526252635264526552665267526852695270527152725273527452755276527752785279528052815282528352845285528652875288528952905291529252935294529552965297529852995300530153025303530453055306530753085309531053115312531353145315531653175318531953205321532253235324532553265327532853295330533153325333533453355336533753385339534053415342534353445345534653475348534953505351535253535354535553565357535853595360536153625363536453655366536753685369537053715372537353745375537653775378537953805381538253835384538553865387538853895390539153925393539453955396539753985399540054015402540354045405540654075408540954105411541254135414541554165417541854195420542154225423542454255426542754285429543054315432543354345435543654375438543954405441544254435444544554465447544854495450545154525453545454555456545754585459546054615462546354645465546654675468546954705471547254735474547554765477547854795480548154825483548454855486548754885489549054915492549354945495549654975498549955005501550255035504550555065507550855095510551155125513551455155516551755185519552055215522552355245525552655275528552955305531553255335534553555365537553855395540554155425543554455455546554755485549555055515552555355545555555655575558555955605561556255635564556555665567556855695570557155725573557455755576557755785579558055815582558355845585558655875588558955905591559255935594559555965597559855995600560156025603560456055606560756085609561056115612561356145615561656175618561956205621562256235624562556265627562856295630563156325633563456355636563756385639564056415642564356445645564656475648564956505651565256535654565556565657565856595660566156625663566456655666566756685669567056715672567356745675567656775678567956805681568256835684568556865687568856895690569156925693569456955696569756985699570057015702570357045705570657075708570957105711571257135714571557165717571857195720572157225723572457255726572757285729573057315732573357345735573657375738573957405741574257435744574557465747574857495750575157525753575457555756575757585759576057615762576357645765576657675768576957705771577257735774577557765777577857795780578157825783578457855786578757885789579057915792579357945795579657975798579958005801580258035804580558065807580858095810581158125813581458155816581758185819582058215822582358245825582658275828582958305831583258335834583558365837583858395840584158425843584458455846584758485849585058515852585358545855585658575858585958605861586258635864586558665867586858695870587158725873587458755876587758785879588058815882588358845885588658875888588958905891589258935894589558965897589858995900590159025903590459055906590759085909591059115912591359145915591659175918591959205921592259235924592559265927592859295930593159325933593459355936593759385939594059415942594359445945594659475948594959505951595259535954595559565957595859595960596159625963596459655966596759685969597059715972597359745975597659775978597959805981598259835984598559865987598859895990599159925993599459955996599759985999600060016002600360046005600660076008600960106011601260136014601560166017601860196020602160226023602460256026602760286029603060316032603360346035603660376038603960406041604260436044604560466047604860496050605160526053605460556056605760586059606060616062606360646065606660676068606960706071607260736074607560766077607860796080608160826083608460856086608760886089609060916092609360946095609660976098609961006101610261036104610561066107610861096110611161126113611461156116611761186119612061216122612361246125612661276128612961306131613261336134613561366137613861396140614161426143614461456146614761486149615061516152615361546155615661576158615961606161616261636164616561666167616861696170617161726173617461756176617761786179618061816182618361846185618661876188618961906191619261936194619561966197619861996200620162026203620462056206620762086209621062116212621362146215621662176218621962206221622262236224622562266227622862296230623162326233623462356236623762386239624062416242624362446245624662476248624962506251625262536254625562566257625862596260626162626263626462656266626762686269627062716272627362746275627662776278627962806281628262836284628562866287628862896290629162926293629462956296629762986299630063016302630363046305630663076308630963106311631263136314631563166317631863196320632163226323632463256326632763286329633063316332633363346335633663376338633963406341634263436344634563466347634863496350635163526353635463556356635763586359636063616362636363646365636663676368636963706371637263736374637563766377637863796380638163826383638463856386638763886389639063916392639363946395639663976398639964006401640264036404640564066407640864096410641164126413641464156416641764186419642064216422642364246425642664276428642964306431643264336434643564366437643864396440644164426443644464456446644764486449645064516452645364546455645664576458645964606461646264636464646564666467646864696470647164726473647464756476647764786479648064816482648364846485648664876488648964906491649264936494649564966497649864996500650165026503650465056506650765086509651065116512651365146515651665176518651965206521652265236524652565266527652865296530653165326533653465356536653765386539654065416542654365446545654665476548654965506551655265536554655565566557655865596560656165626563656465656566656765686569657065716572657365746575657665776578657965806581658265836584658565866587658865896590659165926593659465956596659765986599660066016602660366046605660666076608660966106611661266136614661566166617661866196620662166226623662466256626662766286629663066316632663366346635663666376638663966406641664266436644664566466647664866496650665166526653665466556656665766586659666066616662666366646665666666676668666966706671667266736674667566766677667866796680668166826683668466856686668766886689669066916692669366946695669666976698669967006701670267036704670567066707670867096710671167126713671467156716671767186719672067216722672367246725672667276728672967306731673267336734673567366737673867396740674167426743674467456746674767486749675067516752675367546755675667576758675967606761676267636764676567666767676867696770677167726773677467756776677767786779678067816782678367846785678667876788678967906791679267936794679567966797679867996800680168026803680468056806680768086809681068116812681368146815681668176818681968206821682268236824682568266827682868296830683168326833683468356836683768386839684068416842684368446845684668476848684968506851685268536854685568566857685868596860686168626863686468656866686768686869687068716872687368746875687668776878687968806881688268836884688568866887688868896890689168926893689468956896689768986899690069016902690369046905690669076908690969106911691269136914691569166917691869196920692169226923692469256926692769286929693069316932693369346935693669376938693969406941694269436944694569466947694869496950695169526953695469556956695769586959696069616962696369646965696669676968696969706971697269736974697569766977697869796980698169826983698469856986698769886989699069916992699369946995699669976998699970007001700270037004700570067007700870097010701170127013701470157016701770187019702070217022702370247025702670277028702970307031703270337034703570367037703870397040704170427043704470457046704770487049705070517052705370547055705670577058705970607061706270637064706570667067706870697070707170727073707470757076707770787079708070817082708370847085708670877088708970907091709270937094709570967097709870997100710171027103710471057106710771087109711071117112711371147115711671177118711971207121712271237124712571267127712871297130713171327133713471357136713771387139714071417142714371447145714671477148714971507151715271537154715571567157715871597160716171627163716471657166716771687169717071717172717371747175717671777178717971807181718271837184718571867187718871897190719171927193719471957196719771987199720072017202720372047205720672077208720972107211721272137214721572167217721872197220722172227223722472257226722772287229723072317232723372347235723672377238723972407241724272437244724572467247724872497250725172527253725472557256725772587259726072617262726372647265726672677268726972707271727272737274727572767277727872797280728172827283728472857286728772887289729072917292729372947295729672977298729973007301730273037304730573067307730873097310731173127313731473157316731773187319732073217322732373247325732673277328732973307331733273337334733573367337733873397340734173427343734473457346734773487349735073517352735373547355735673577358735973607361736273637364736573667367736873697370737173727373737473757376737773787379738073817382738373847385738673877388738973907391739273937394739573967397739873997400740174027403740474057406740774087409741074117412741374147415741674177418741974207421742274237424742574267427742874297430743174327433743474357436743774387439744074417442744374447445744674477448744974507451745274537454745574567457745874597460746174627463746474657466746774687469747074717472747374747475747674777478747974807481748274837484748574867487748874897490749174927493749474957496749774987499750075017502750375047505750675077508750975107511751275137514751575167517751875197520752175227523752475257526752775287529753075317532753375347535753675377538753975407541754275437544754575467547754875497550755175527553755475557556755775587559756075617562756375647565756675677568756975707571757275737574757575767577757875797580758175827583758475857586758775887589759075917592759375947595759675977598759976007601760276037604760576067607760876097610761176127613761476157616761776187619762076217622762376247625762676277628762976307631763276337634763576367637763876397640764176427643764476457646764776487649765076517652765376547655765676577658765976607661766276637664766576667667766876697670767176727673767476757676767776787679768076817682768376847685768676877688768976907691769276937694769576967697769876997700770177027703770477057706770777087709771077117712771377147715771677177718771977207721772277237724772577267727772877297730773177327733773477357736773777387739774077417742774377447745774677477748774977507751775277537754775577567757775877597760776177627763776477657766776777687769777077717772777377747775777677777778777977807781778277837784778577867787778877897790779177927793779477957796779777987799780078017802780378047805780678077808780978107811781278137814781578167817781878197820782178227823782478257826782778287829783078317832783378347835783678377838783978407841784278437844784578467847784878497850785178527853785478557856785778587859786078617862786378647865786678677868786978707871787278737874787578767877787878797880788178827883788478857886788778887889789078917892789378947895789678977898789979007901790279037904790579067907790879097910791179127913791479157916791779187919792079217922792379247925792679277928792979307931793279337934793579367937793879397940794179427943794479457946794779487949795079517952795379547955795679577958795979607961796279637964796579667967796879697970797179727973797479757976797779787979798079817982798379847985798679877988798979907991799279937994799579967997799879998000800180028003800480058006800780088009801080118012801380148015801680178018801980208021802280238024802580268027802880298030803180328033803480358036803780388039804080418042804380448045804680478048804980508051805280538054805580568057805880598060806180628063806480658066806780688069807080718072807380748075807680778078807980808081808280838084808580868087808880898090809180928093809480958096809780988099810081018102810381048105810681078108810981108111811281138114811581168117811881198120812181228123812481258126812781288129813081318132813381348135813681378138813981408141814281438144814581468147814881498150815181528153815481558156815781588159816081618162816381648165816681678168816981708171817281738174817581768177817881798180818181828183818481858186818781888189819081918192819381948195819681978198819982008201820282038204820582068207820882098210821182128213821482158216821782188219822082218222822382248225822682278228822982308231823282338234823582368237823882398240824182428243824482458246824782488249825082518252825382548255825682578258825982608261826282638264826582668267826882698270827182728273827482758276827782788279828082818282828382848285828682878288828982908291829282938294829582968297829882998300830183028303830483058306830783088309831083118312831383148315831683178318831983208321832283238324832583268327832883298330833183328333833483358336833783388339834083418342834383448345834683478348834983508351835283538354835583568357835883598360836183628363836483658366836783688369837083718372837383748375837683778378837983808381838283838384838583868387838883898390839183928393839483958396839783988399840084018402840384048405840684078408840984108411841284138414841584168417841884198420842184228423842484258426842784288429843084318432843384348435843684378438843984408441844284438444844584468447844884498450845184528453845484558456845784588459846084618462846384648465846684678468846984708471847284738474847584768477847884798480848184828483848484858486848784888489849084918492849384948495849684978498849985008501850285038504850585068507850885098510851185128513851485158516851785188519852085218522852385248525852685278528852985308531853285338534853585368537853885398540854185428543854485458546854785488549855085518552855385548555855685578558855985608561856285638564856585668567856885698570857185728573857485758576857785788579858085818582858385848585858685878588858985908591859285938594859585968597859885998600860186028603860486058606860786088609861086118612861386148615861686178618861986208621862286238624862586268627862886298630863186328633863486358636863786388639864086418642864386448645864686478648864986508651865286538654865586568657865886598660866186628663866486658666866786688669867086718672867386748675867686778678867986808681868286838684868586868687868886898690869186928693869486958696869786988699870087018702870387048705870687078708870987108711871287138714871587168717871887198720872187228723872487258726872787288729873087318732873387348735873687378738873987408741874287438744874587468747874887498750875187528753875487558756875787588759876087618762876387648765876687678768876987708771877287738774877587768777877887798780878187828783878487858786878787888789879087918792879387948795879687978798879988008801880288038804880588068807880888098810881188128813881488158816881788188819882088218822882388248825882688278828882988308831883288338834883588368837883888398840884188428843884488458846884788488849885088518852885388548855885688578858885988608861886288638864886588668867886888698870887188728873887488758876887788788879888088818882888388848885888688878888888988908891889288938894889588968897889888998900890189028903890489058906890789088909891089118912891389148915891689178918891989208921892289238924892589268927892889298930893189328933893489358936893789388939894089418942894389448945894689478948894989508951895289538954895589568957895889598960896189628963896489658966896789688969897089718972897389748975897689778978897989808981898289838984898589868987898889898990899189928993899489958996899789988999900090019002900390049005900690079008900990109011901290139014901590169017901890199020902190229023902490259026902790289029903090319032903390349035903690379038903990409041904290439044904590469047904890499050905190529053905490559056905790589059906090619062906390649065906690679068906990709071907290739074907590769077907890799080908190829083908490859086908790889089909090919092909390949095909690979098909991009101910291039104910591069107910891099110911191129113911491159116911791189119912091219122912391249125912691279128912991309131913291339134913591369137913891399140914191429143914491459146914791489149915091519152915391549155915691579158915991609161916291639164916591669167916891699170917191729173917491759176917791789179918091819182918391849185918691879188918991909191919291939194919591969197919891999200920192029203920492059206920792089209921092119212921392149215921692179218921992209221922292239224922592269227922892299230923192329233923492359236923792389239924092419242924392449245924692479248924992509251925292539254925592569257925892599260926192629263926492659266926792689269927092719272927392749275927692779278927992809281928292839284928592869287928892899290929192929293929492959296929792989299930093019302930393049305930693079308930993109311931293139314931593169317931893199320932193229323932493259326932793289329933093319332933393349335933693379338933993409341934293439344934593469347934893499350935193529353935493559356935793589359936093619362936393649365936693679368936993709371937293739374937593769377937893799380938193829383938493859386938793889389939093919392939393949395939693979398939994009401940294039404940594069407940894099410941194129413941494159416941794189419942094219422942394249425942694279428942994309431943294339434943594369437943894399440944194429443944494459446944794489449945094519452945394549455945694579458945994609461946294639464946594669467946894699470947194729473947494759476947794789479948094819482948394849485948694879488948994909491949294939494949594969497949894999500950195029503950495059506950795089509951095119512951395149515951695179518951995209521952295239524952595269527952895299530953195329533953495359536953795389539954095419542954395449545954695479548954995509551955295539554955595569557955895599560956195629563956495659566956795689569957095719572957395749575957695779578957995809581958295839584958595869587958895899590959195929593959495959596959795989599960096019602960396049605960696079608960996109611961296139614961596169617961896199620962196229623962496259626962796289629963096319632963396349635963696379638963996409641964296439644964596469647964896499650965196529653965496559656965796589659966096619662966396649665966696679668966996709671967296739674967596769677967896799680968196829683968496859686968796889689969096919692969396949695969696979698969997009701970297039704970597069707970897099710971197129713971497159716971797189719972097219722972397249725972697279728972997309731973297339734973597369737973897399740974197429743974497459746974797489749975097519752975397549755975697579758975997609761976297639764976597669767976897699770977197729773977497759776977797789779978097819782978397849785978697879788978997909791979297939794979597969797979897999800980198029803980498059806980798089809981098119812981398149815981698179818981998209821982298239824982598269827982898299830983198329833983498359836983798389839984098419842984398449845984698479848984998509851985298539854985598569857985898599860986198629863986498659866986798689869987098719872987398749875987698779878987998809881988298839884988598869887988898899890989198929893989498959896989798989899990099019902990399049905990699079908990999109911991299139914991599169917991899199920992199229923992499259926992799289929993099319932993399349935993699379938993999409941994299439944994599469947994899499950995199529953995499559956995799589959996099619962996399649965996699679968996999709971997299739974997599769977997899799980998199829983998499859986998799889989999099919992999399949995999699979998999910000100011000210003100041000510006100071000810009100101001110012100131001410015100161001710018100191002010021100221002310024100251002610027100281002910030100311003210033100341003510036100371003810039100401004110042100431004410045100461004710048100491005010051100521005310054100551005610057100581005910060100611006210063100641006510066100671006810069100701007110072100731007410075100761007710078100791008010081100821008310084100851008610087100881008910090100911009210093100941009510096100971009810099101001010110102101031010410105101061010710108101091011010111101121011310114101151011610117101181011910120101211012210123101241012510126101271012810129101301013110132101331013410135101361013710138101391014010141101421014310144101451014610147101481014910150101511015210153101541015510156101571015810159101601016110162101631016410165101661016710168101691017010171101721017310174101751017610177101781017910180101811018210183101841018510186101871018810189101901019110192101931019410195101961019710198101991020010201102021020310204102051020610207102081020910210102111021210213102141021510216102171021810219102201022110222102231022410225102261022710228102291023010231102321023310234102351023610237102381023910240102411024210243102441024510246102471024810249102501025110252102531025410255102561025710258102591026010261102621026310264102651026610267102681026910270102711027210273102741027510276102771027810279102801028110282102831028410285102861028710288102891029010291102921029310294102951029610297102981029910300103011030210303103041030510306103071030810309103101031110312103131031410315103161031710318103191032010321103221032310324103251032610327103281032910330103311033210333103341033510336103371033810339103401034110342103431034410345103461034710348103491035010351103521035310354103551035610357103581035910360103611036210363103641036510366103671036810369103701037110372103731037410375103761037710378103791038010381103821038310384103851038610387103881038910390103911039210393103941039510396103971039810399104001040110402104031040410405104061040710408104091041010411104121041310414104151041610417104181041910420104211042210423104241042510426104271042810429104301043110432104331043410435104361043710438104391044010441104421044310444104451044610447104481044910450104511045210453104541045510456104571045810459104601046110462104631046410465104661046710468104691047010471104721047310474104751047610477104781047910480104811048210483104841048510486104871048810489104901049110492104931049410495104961049710498104991050010501105021050310504105051050610507105081050910510105111051210513105141051510516105171051810519105201052110522105231052410525105261052710528105291053010531105321053310534105351053610537105381053910540105411054210543105441054510546105471054810549105501055110552105531055410555105561055710558105591056010561105621056310564105651056610567105681056910570105711057210573105741057510576105771057810579105801058110582105831058410585105861058710588105891059010591105921059310594105951059610597105981059910600106011060210603106041060510606106071060810609106101061110612106131061410615106161061710618106191062010621106221062310624106251062610627106281062910630106311063210633106341063510636106371063810639106401064110642106431064410645106461064710648106491065010651106521065310654106551065610657106581065910660106611066210663106641066510666106671066810669106701067110672106731067410675106761067710678106791068010681106821068310684106851068610687106881068910690106911069210693106941069510696106971069810699107001070110702107031070410705107061070710708107091071010711107121071310714107151071610717107181071910720107211072210723107241072510726107271072810729107301073110732107331073410735107361073710738107391074010741107421074310744107451074610747107481074910750107511075210753107541075510756107571075810759107601076110762107631076410765107661076710768107691077010771107721077310774107751077610777107781077910780107811078210783107841078510786107871078810789107901079110792107931079410795107961079710798107991080010801108021080310804108051080610807108081080910810108111081210813108141081510816108171081810819108201082110822108231082410825108261082710828108291083010831108321083310834108351083610837108381083910840108411084210843108441084510846108471084810849108501085110852108531085410855108561085710858108591086010861108621086310864108651086610867108681086910870108711087210873108741087510876108771087810879108801088110882108831088410885108861088710888108891089010891108921089310894108951089610897108981089910900109011090210903109041090510906109071090810909109101091110912109131091410915109161091710918109191092010921109221092310924109251092610927109281092910930109311093210933109341093510936109371093810939109401094110942109431094410945109461094710948109491095010951109521095310954109551095610957109581095910960109611096210963109641096510966109671096810969109701097110972109731097410975109761097710978109791098010981109821098310984109851098610987109881098910990109911099210993109941099510996109971099810999110001100111002110031100411005110061100711008110091101011011110121101311014110151101611017110181101911020110211102211023110241102511026110271102811029110301103111032110331103411035110361103711038110391104011041110421104311044110451104611047110481104911050110511105211053110541105511056110571105811059110601106111062110631106411065110661106711068110691107011071110721107311074110751107611077110781107911080110811108211083110841108511086110871108811089110901109111092110931109411095110961109711098110991110011101111021110311104111051110611107111081110911110111111111211113111141111511116111171111811119111201112111122111231112411125111261112711128111291113011131111321113311134111351113611137111381113911140111411114211143111441114511146111471114811149111501115111152111531115411155111561115711158111591116011161111621116311164111651116611167111681116911170111711117211173111741117511176111771117811179111801118111182111831118411185111861118711188111891119011191111921119311194111951119611197111981119911200112011120211203112041120511206112071120811209112101121111212112131121411215112161121711218112191122011221112221122311224112251122611227112281122911230112311123211233112341123511236112371123811239112401124111242112431124411245112461124711248112491125011251112521125311254112551125611257112581125911260112611126211263112641126511266112671126811269112701127111272112731127411275112761127711278112791128011281112821128311284112851128611287112881128911290112911129211293112941129511296112971129811299113001130111302113031130411305113061130711308113091131011311113121131311314113151131611317113181131911320113211132211323113241132511326113271132811329113301133111332113331133411335113361133711338113391134011341113421134311344113451134611347113481134911350113511135211353113541135511356113571135811359113601136111362113631136411365113661136711368113691137011371113721137311374113751137611377113781137911380113811138211383113841138511386113871138811389113901139111392113931139411395113961139711398113991140011401114021140311404114051140611407114081140911410114111141211413114141141511416114171141811419114201142111422114231142411425114261142711428114291143011431114321143311434114351143611437114381143911440114411144211443114441144511446114471144811449114501145111452114531145411455114561145711458114591146011461114621146311464114651146611467114681146911470114711147211473114741147511476114771147811479114801148111482114831148411485114861148711488114891149011491114921149311494114951149611497114981149911500115011150211503115041150511506115071150811509115101151111512115131151411515115161151711518115191152011521115221152311524115251152611527115281152911530115311153211533115341153511536115371153811539115401154111542115431154411545115461154711548115491155011551115521155311554115551155611557115581155911560115611156211563115641156511566115671156811569115701157111572115731157411575115761157711578115791158011581115821158311584115851158611587115881158911590115911159211593115941159511596115971159811599116001160111602116031160411605116061160711608116091161011611116121161311614116151161611617116181161911620116211162211623116241162511626116271162811629116301163111632116331163411635116361163711638116391164011641116421164311644116451164611647116481164911650116511165211653116541165511656116571165811659116601166111662116631166411665116661166711668116691167011671116721167311674116751167611677116781167911680116811168211683116841168511686116871168811689116901169111692116931169411695116961169711698116991170011701117021170311704117051170611707117081170911710117111171211713117141171511716117171171811719117201172111722117231172411725117261172711728117291173011731117321173311734117351173611737117381173911740117411174211743117441174511746117471174811749117501175111752117531175411755117561175711758117591176011761117621176311764117651176611767117681176911770117711177211773117741177511776117771177811779117801178111782117831178411785117861178711788117891179011791117921179311794117951179611797117981179911800118011180211803118041180511806118071180811809118101181111812118131181411815118161181711818118191182011821118221182311824118251182611827118281182911830118311183211833118341183511836118371183811839118401184111842118431184411845118461184711848118491185011851118521185311854118551185611857118581185911860118611186211863118641186511866118671186811869118701187111872118731187411875118761187711878118791188011881118821188311884118851188611887118881188911890118911189211893118941189511896118971189811899119001190111902119031190411905119061190711908119091191011911119121191311914119151191611917119181191911920119211192211923119241192511926119271192811929119301193111932119331193411935119361193711938119391194011941119421194311944119451194611947119481194911950119511195211953119541195511956119571195811959119601196111962119631196411965119661196711968119691197011971119721197311974119751197611977119781197911980119811198211983119841198511986119871198811989119901199111992119931199411995119961199711998119991200012001120021200312004120051200612007120081200912010120111201212013120141201512016120171201812019120201202112022120231202412025120261202712028120291203012031120321203312034120351203612037120381203912040120411204212043120441204512046120471204812049120501205112052120531205412055120561205712058120591206012061120621206312064120651206612067120681206912070120711207212073120741207512076120771207812079120801208112082120831208412085120861208712088120891209012091120921209312094120951209612097120981209912100121011210212103121041210512106121071210812109121101211112112121131211412115121161211712118121191212012121121221212312124121251212612127121281212912130121311213212133121341213512136121371213812139121401214112142121431214412145121461214712148121491215012151121521215312154121551215612157121581215912160121611216212163121641216512166121671216812169121701217112172121731217412175121761217712178121791218012181121821218312184121851218612187121881218912190121911219212193121941219512196121971219812199122001220112202122031220412205122061220712208122091221012211122121221312214122151221612217122181221912220122211222212223122241222512226122271222812229122301223112232122331223412235122361223712238122391224012241122421224312244122451224612247122481224912250122511225212253122541225512256122571225812259122601226112262122631226412265122661226712268122691227012271122721227312274122751227612277122781227912280122811228212283122841228512286122871228812289122901229112292122931229412295122961229712298122991230012301123021230312304123051230612307123081230912310123111231212313123141231512316123171231812319123201232112322123231232412325123261232712328123291233012331123321233312334123351233612337123381233912340123411234212343123441234512346123471234812349123501235112352123531235412355123561235712358123591236012361123621236312364123651236612367123681236912370123711237212373123741237512376123771237812379123801238112382123831238412385123861238712388123891239012391123921239312394123951239612397123981239912400124011240212403124041240512406124071240812409124101241112412124131241412415124161241712418124191242012421124221242312424124251242612427124281242912430124311243212433124341243512436124371243812439124401244112442124431244412445124461244712448124491245012451124521245312454124551245612457124581245912460124611246212463124641246512466124671246812469124701247112472124731247412475124761247712478124791248012481124821248312484124851248612487124881248912490124911249212493124941249512496124971249812499125001250112502125031250412505125061250712508125091251012511125121251312514125151251612517125181251912520125211252212523125241252512526125271252812529125301253112532125331253412535125361253712538125391254012541125421254312544125451254612547125481254912550125511255212553125541255512556125571255812559125601256112562125631256412565125661256712568125691257012571125721257312574125751257612577125781257912580125811258212583125841258512586125871258812589125901259112592125931259412595125961259712598125991260012601126021260312604126051260612607126081260912610126111261212613126141261512616126171261812619126201262112622126231262412625126261262712628126291263012631126321263312634126351263612637126381263912640126411264212643126441264512646126471264812649126501265112652126531265412655126561265712658126591266012661126621266312664126651266612667126681266912670126711267212673126741267512676126771267812679126801268112682126831268412685126861268712688126891269012691126921269312694126951269612697126981269912700127011270212703127041270512706127071270812709127101271112712127131271412715127161271712718127191272012721127221272312724127251272612727127281272912730127311273212733127341273512736127371273812739127401274112742127431274412745127461274712748127491275012751127521275312754127551275612757127581275912760127611276212763127641276512766127671276812769127701277112772127731277412775127761277712778127791278012781127821278312784127851278612787127881278912790127911279212793127941279512796127971279812799128001280112802128031280412805128061280712808128091281012811128121281312814128151281612817128181281912820128211282212823128241282512826128271282812829128301283112832128331283412835128361283712838128391284012841128421284312844128451284612847128481284912850128511285212853128541285512856128571285812859128601286112862128631286412865128661286712868128691287012871128721287312874128751287612877128781287912880128811288212883128841288512886128871288812889128901289112892128931289412895128961289712898128991290012901129021290312904129051290612907129081290912910129111291212913129141291512916129171291812919129201292112922129231292412925129261292712928129291293012931129321293312934129351293612937129381293912940129411294212943129441294512946129471294812949129501295112952129531295412955129561295712958129591296012961129621296312964129651296612967129681296912970129711297212973129741297512976129771297812979129801298112982129831298412985129861298712988129891299012991129921299312994129951299612997129981299913000130011300213003130041300513006130071300813009130101301113012130131301413015130161301713018130191302013021130221302313024130251302613027130281302913030130311303213033130341303513036130371303813039130401304113042130431304413045130461304713048130491305013051130521305313054130551305613057130581305913060130611306213063130641306513066130671306813069130701307113072130731307413075130761307713078130791308013081130821308313084130851308613087130881308913090130911309213093130941309513096130971309813099131001310113102131031310413105131061310713108131091311013111131121311313114131151311613117131181311913120131211312213123131241312513126131271312813129131301313113132131331313413135131361313713138131391314013141131421314313144131451314613147131481314913150131511315213153131541315513156131571315813159131601316113162131631316413165131661316713168131691317013171131721317313174131751317613177131781317913180131811318213183131841318513186131871318813189131901319113192131931319413195131961319713198131991320013201132021320313204132051320613207132081320913210132111321213213132141321513216132171321813219132201322113222132231322413225132261322713228132291323013231132321323313234132351323613237132381323913240132411324213243132441324513246132471324813249132501325113252132531325413255132561325713258132591326013261132621326313264132651326613267132681326913270132711327213273132741327513276132771327813279132801328113282132831328413285132861328713288132891329013291132921329313294132951329613297132981329913300133011330213303133041330513306133071330813309133101331113312133131331413315133161331713318133191332013321133221332313324133251332613327133281332913330133311333213333133341333513336133371333813339133401334113342133431334413345133461334713348133491335013351133521335313354133551335613357133581335913360133611336213363133641336513366133671336813369133701337113372133731337413375133761337713378133791338013381133821338313384133851338613387133881338913390133911339213393133941339513396133971339813399134001340113402134031340413405134061340713408134091341013411134121341313414134151341613417134181341913420134211342213423134241342513426134271342813429134301343113432134331343413435134361343713438134391344013441134421344313444134451344613447134481344913450134511345213453134541345513456134571345813459134601346113462134631346413465134661346713468134691347013471134721347313474134751347613477134781347913480134811348213483134841348513486134871348813489134901349113492134931349413495134961349713498134991350013501135021350313504135051350613507135081350913510135111351213513135141351513516135171351813519135201352113522135231352413525135261352713528135291353013531135321353313534135351353613537135381353913540135411354213543135441354513546135471354813549135501355113552135531355413555135561355713558135591356013561135621356313564135651356613567135681356913570135711357213573135741357513576135771357813579135801358113582135831358413585135861358713588135891359013591135921359313594135951359613597135981359913600136011360213603136041360513606136071360813609136101361113612136131361413615136161361713618136191362013621136221362313624136251362613627136281362913630136311363213633136341363513636136371363813639136401364113642136431364413645136461364713648136491365013651136521365313654136551365613657136581365913660136611366213663136641366513666136671366813669136701367113672136731367413675136761367713678136791368013681136821368313684136851368613687136881368913690136911369213693136941369513696136971369813699137001370113702137031370413705137061370713708137091371013711137121371313714137151371613717137181371913720137211372213723137241372513726137271372813729137301373113732137331373413735137361373713738137391374013741137421374313744137451374613747137481374913750137511375213753137541375513756137571375813759137601376113762137631376413765137661376713768137691377013771137721377313774137751377613777137781377913780137811378213783137841378513786137871378813789137901379113792137931379413795137961379713798137991380013801138021380313804138051380613807138081380913810138111381213813138141381513816138171381813819138201382113822138231382413825138261382713828138291383013831138321383313834138351383613837138381383913840138411384213843138441384513846138471384813849138501385113852138531385413855138561385713858138591386013861138621386313864138651386613867138681386913870138711387213873138741387513876138771387813879138801388113882138831388413885138861388713888138891389013891138921389313894138951389613897138981389913900139011390213903139041390513906139071390813909139101391113912139131391413915139161391713918139191392013921139221392313924139251392613927139281392913930139311393213933139341393513936139371393813939139401394113942139431394413945139461394713948139491395013951139521395313954139551395613957139581395913960139611396213963139641396513966139671396813969139701397113972139731397413975139761397713978139791398013981139821398313984139851398613987139881398913990139911399213993139941399513996139971399813999140001400114002140031400414005140061400714008140091401014011140121401314014140151401614017140181401914020140211402214023140241402514026140271402814029140301403114032140331403414035140361403714038140391404014041140421404314044140451404614047140481404914050140511405214053140541405514056140571405814059140601406114062140631406414065140661406714068140691407014071140721407314074140751407614077140781407914080140811408214083140841408514086140871408814089140901409114092140931409414095140961409714098140991410014101141021410314104141051410614107141081410914110141111411214113141141411514116141171411814119141201412114122141231412414125141261412714128141291413014131141321413314134141351413614137141381413914140141411414214143141441414514146141471414814149141501415114152141531415414155141561415714158141591416014161141621416314164141651416614167141681416914170141711417214173141741417514176141771417814179141801418114182141831418414185141861418714188141891419014191141921419314194141951419614197141981419914200142011420214203142041420514206142071420814209142101421114212142131421414215142161421714218142191422014221142221422314224142251422614227142281422914230142311423214233142341423514236142371423814239142401424114242142431424414245142461424714248142491425014251142521425314254142551425614257142581425914260142611426214263142641426514266142671426814269142701427114272142731427414275142761427714278142791428014281142821428314284142851428614287142881428914290142911429214293142941429514296142971429814299143001430114302143031430414305143061430714308143091431014311143121431314314143151431614317143181431914320143211432214323143241432514326143271432814329143301433114332143331433414335143361433714338143391434014341143421434314344143451434614347143481434914350143511435214353143541435514356143571435814359143601436114362143631436414365143661436714368143691437014371143721437314374143751437614377143781437914380143811438214383143841438514386143871438814389143901439114392143931439414395143961439714398143991440014401144021440314404144051440614407144081440914410144111441214413144141441514416144171441814419144201442114422144231442414425144261442714428144291443014431144321443314434144351443614437144381443914440144411444214443144441444514446144471444814449144501445114452144531445414455144561445714458144591446014461144621446314464144651446614467144681446914470144711447214473144741447514476144771447814479144801448114482144831448414485144861448714488144891449014491144921449314494144951449614497144981449914500145011450214503145041450514506145071450814509145101451114512145131451414515145161451714518145191452014521145221452314524145251452614527145281452914530145311453214533145341453514536145371453814539145401454114542145431454414545145461454714548145491455014551145521455314554145551455614557145581455914560145611456214563145641456514566145671456814569145701457114572145731457414575145761457714578145791458014581145821458314584145851458614587145881458914590145911459214593145941459514596145971459814599146001460114602146031460414605146061460714608146091461014611146121461314614146151461614617146181461914620146211462214623146241462514626146271462814629146301463114632146331463414635146361463714638146391464014641146421464314644146451464614647146481464914650146511465214653146541465514656146571465814659146601466114662146631466414665146661466714668146691467014671146721467314674146751467614677146781467914680146811468214683146841468514686146871468814689146901469114692146931469414695146961469714698146991470014701147021470314704147051470614707147081470914710147111471214713147141471514716147171471814719147201472114722147231472414725147261472714728147291473014731147321473314734147351473614737147381473914740147411474214743147441474514746147471474814749147501475114752147531475414755147561475714758147591476014761147621476314764147651476614767147681476914770147711477214773147741477514776147771477814779147801478114782147831478414785147861478714788147891479014791147921479314794147951479614797147981479914800148011480214803148041480514806148071480814809148101481114812148131481414815148161481714818148191482014821148221482314824148251482614827148281482914830148311483214833148341483514836148371483814839148401484114842148431484414845148461484714848148491485014851148521485314854148551485614857148581485914860148611486214863148641486514866148671486814869148701487114872148731487414875148761487714878148791488014881148821488314884148851488614887148881488914890148911489214893148941489514896148971489814899149001490114902149031490414905149061490714908149091491014911149121491314914149151491614917149181491914920149211492214923149241492514926149271492814929149301493114932149331493414935149361493714938149391494014941149421494314944149451494614947149481494914950149511495214953149541495514956149571495814959149601496114962149631496414965149661496714968149691497014971149721497314974149751497614977149781497914980149811498214983149841498514986149871498814989149901499114992149931499414995149961499714998149991500015001150021500315004150051500615007150081500915010150111501215013150141501515016150171501815019150201502115022150231502415025150261502715028150291503015031150321503315034150351503615037150381503915040150411504215043150441504515046150471504815049150501505115052150531505415055150561505715058150591506015061150621506315064150651506615067150681506915070150711507215073150741507515076150771507815079150801508115082150831508415085150861508715088150891509015091150921509315094150951509615097150981509915100151011510215103151041510515106151071510815109151101511115112151131511415115151161511715118151191512015121151221512315124151251512615127151281512915130151311513215133151341513515136151371513815139151401514115142151431514415145151461514715148151491515015151151521515315154151551515615157151581515915160151611516215163151641516515166151671516815169151701517115172151731517415175151761517715178151791518015181151821518315184151851518615187151881518915190151911519215193151941519515196151971519815199152001520115202152031520415205152061520715208152091521015211152121521315214152151521615217152181521915220152211522215223152241522515226152271522815229152301523115232152331523415235152361523715238152391524015241152421524315244152451524615247152481524915250152511525215253152541525515256152571525815259152601526115262152631526415265152661526715268152691527015271152721527315274152751527615277152781527915280152811528215283152841528515286152871528815289152901529115292152931529415295152961529715298152991530015301153021530315304153051530615307153081530915310153111531215313153141531515316153171531815319153201532115322153231532415325153261532715328153291533015331153321533315334153351533615337153381533915340153411534215343153441534515346153471534815349153501535115352153531535415355153561535715358153591536015361153621536315364153651536615367153681536915370153711537215373153741537515376153771537815379153801538115382153831538415385153861538715388153891539015391153921539315394153951539615397153981539915400154011540215403154041540515406154071540815409154101541115412154131541415415154161541715418154191542015421154221542315424154251542615427154281542915430154311543215433154341543515436154371543815439154401544115442154431544415445154461544715448154491545015451154521545315454154551545615457154581545915460154611546215463154641546515466154671546815469154701547115472154731547415475154761547715478154791548015481154821548315484154851548615487154881548915490154911549215493154941549515496154971549815499155001550115502155031550415505155061550715508155091551015511155121551315514155151551615517155181551915520155211552215523155241552515526155271552815529155301553115532155331553415535155361553715538155391554015541155421554315544155451554615547155481554915550155511555215553155541555515556155571555815559155601556115562155631556415565155661556715568155691557015571155721557315574155751557615577155781557915580155811558215583155841558515586155871558815589155901559115592155931559415595155961559715598155991560015601156021560315604156051560615607156081560915610156111561215613156141561515616156171561815619156201562115622156231562415625156261562715628156291563015631156321563315634156351563615637156381563915640156411564215643156441564515646156471564815649156501565115652156531565415655156561565715658156591566015661156621566315664156651566615667156681566915670156711567215673156741567515676156771567815679156801568115682156831568415685156861568715688156891569015691156921569315694156951569615697156981569915700157011570215703157041570515706157071570815709157101571115712157131571415715157161571715718157191572015721157221572315724157251572615727157281572915730157311573215733157341573515736157371573815739157401574115742157431574415745157461574715748157491575015751157521575315754157551575615757157581575915760157611576215763157641576515766157671576815769157701577115772157731577415775157761577715778157791578015781157821578315784157851578615787157881578915790157911579215793157941579515796157971579815799158001580115802158031580415805158061580715808158091581015811158121581315814158151581615817158181581915820158211582215823158241582515826158271582815829158301583115832158331583415835158361583715838158391584015841158421584315844158451584615847158481584915850158511585215853158541585515856158571585815859158601586115862158631586415865158661586715868158691587015871158721587315874158751587615877158781587915880158811588215883158841588515886158871588815889158901589115892158931589415895158961589715898158991590015901159021590315904159051590615907159081590915910159111591215913159141591515916159171591815919159201592115922159231592415925159261592715928159291593015931159321593315934159351593615937159381593915940159411594215943159441594515946159471594815949159501595115952159531595415955159561595715958159591596015961159621596315964159651596615967159681596915970159711597215973159741597515976159771597815979159801598115982159831598415985159861598715988159891599015991159921599315994159951599615997159981599916000160011600216003160041600516006160071600816009160101601116012160131601416015160161601716018160191602016021160221602316024160251602616027160281602916030160311603216033160341603516036160371603816039160401604116042160431604416045160461604716048160491605016051160521605316054160551605616057160581605916060160611606216063160641606516066160671606816069160701607116072160731607416075160761607716078160791608016081160821608316084160851608616087160881608916090160911609216093160941609516096160971609816099161001610116102161031610416105161061610716108161091611016111161121611316114161151611616117161181611916120161211612216123161241612516126161271612816129161301613116132161331613416135161361613716138161391614016141161421614316144161451614616147161481614916150161511615216153161541615516156161571615816159161601616116162161631616416165161661616716168161691617016171161721617316174161751617616177161781617916180161811618216183161841618516186161871618816189161901619116192161931619416195161961619716198161991620016201162021620316204162051620616207162081620916210162111621216213162141621516216162171621816219162201622116222162231622416225162261622716228162291623016231162321623316234162351623616237162381623916240162411624216243162441624516246162471624816249162501625116252162531625416255162561625716258162591626016261162621626316264162651626616267162681626916270162711627216273162741627516276162771627816279162801628116282162831628416285162861628716288162891629016291162921629316294162951629616297162981629916300163011630216303163041630516306163071630816309163101631116312163131631416315163161631716318163191632016321163221632316324163251632616327163281632916330163311633216333163341633516336163371633816339163401634116342163431634416345163461634716348163491635016351163521635316354163551635616357163581635916360163611636216363163641636516366163671636816369163701637116372163731637416375163761637716378163791638016381163821638316384163851638616387163881638916390163911639216393163941639516396163971639816399164001640116402164031640416405164061640716408164091641016411164121641316414164151641616417164181641916420164211642216423164241642516426164271642816429164301643116432164331643416435164361643716438164391644016441164421644316444164451644616447164481644916450164511645216453164541645516456164571645816459164601646116462164631646416465164661646716468164691647016471164721647316474164751647616477164781647916480164811648216483164841648516486164871648816489164901649116492164931649416495164961649716498164991650016501165021650316504165051650616507165081650916510165111651216513165141651516516165171651816519165201652116522165231652416525165261652716528165291653016531165321653316534165351653616537165381653916540165411654216543165441654516546165471654816549165501655116552165531655416555165561655716558165591656016561165621656316564165651656616567165681656916570165711657216573165741657516576165771657816579165801658116582165831658416585165861658716588165891659016591165921659316594165951659616597165981659916600166011660216603166041660516606166071660816609166101661116612166131661416615166161661716618166191662016621166221662316624166251662616627166281662916630166311663216633166341663516636166371663816639166401664116642166431664416645166461664716648166491665016651166521665316654166551665616657166581665916660166611666216663166641666516666166671666816669166701667116672166731667416675166761667716678166791668016681166821668316684166851668616687166881668916690166911669216693166941669516696166971669816699167001670116702167031670416705167061670716708167091671016711167121671316714167151671616717167181671916720167211672216723167241672516726167271672816729167301673116732167331673416735167361673716738167391674016741167421674316744167451674616747167481674916750167511675216753167541675516756167571675816759167601676116762167631676416765167661676716768167691677016771167721677316774167751677616777167781677916780167811678216783167841678516786167871678816789167901679116792167931679416795167961679716798167991680016801168021680316804168051680616807168081680916810168111681216813168141681516816168171681816819168201682116822168231682416825168261682716828168291683016831168321683316834168351683616837168381683916840168411684216843168441684516846168471684816849168501685116852168531685416855168561685716858168591686016861168621686316864168651686616867168681686916870168711687216873168741687516876168771687816879168801688116882168831688416885168861688716888168891689016891168921689316894168951689616897168981689916900169011690216903169041690516906169071690816909169101691116912169131691416915169161691716918169191692016921169221692316924169251692616927169281692916930169311693216933169341693516936169371693816939169401694116942169431694416945169461694716948169491695016951169521695316954169551695616957169581695916960169611696216963169641696516966169671696816969169701697116972169731697416975169761697716978169791698016981169821698316984169851698616987169881698916990169911699216993169941699516996169971699816999170001700117002170031700417005170061700717008170091701017011170121701317014170151701617017170181701917020170211702217023170241702517026170271702817029170301703117032170331703417035170361703717038170391704017041170421704317044170451704617047170481704917050170511705217053170541705517056170571705817059170601706117062170631706417065170661706717068170691707017071170721707317074170751707617077170781707917080170811708217083170841708517086170871708817089170901709117092170931709417095170961709717098170991710017101171021710317104171051710617107171081710917110171111711217113171141711517116171171711817119171201712117122171231712417125171261712717128171291713017131171321713317134171351713617137171381713917140171411714217143171441714517146171471714817149171501715117152171531715417155171561715717158171591716017161171621716317164171651716617167171681716917170171711717217173171741717517176171771717817179171801718117182171831718417185171861718717188171891719017191171921719317194171951719617197171981719917200172011720217203172041720517206172071720817209172101721117212172131721417215172161721717218172191722017221172221722317224172251722617227172281722917230172311723217233172341723517236172371723817239172401724117242172431724417245172461724717248172491725017251172521725317254172551725617257172581725917260172611726217263172641726517266172671726817269172701727117272172731727417275172761727717278172791728017281172821728317284172851728617287172881728917290172911729217293172941729517296172971729817299173001730117302173031730417305173061730717308173091731017311173121731317314173151731617317173181731917320173211732217323173241732517326173271732817329173301733117332173331733417335173361733717338173391734017341173421734317344173451734617347173481734917350173511735217353173541735517356173571735817359173601736117362173631736417365173661736717368173691737017371173721737317374173751737617377173781737917380173811738217383173841738517386173871738817389173901739117392173931739417395173961739717398173991740017401174021740317404174051740617407174081740917410174111741217413174141741517416174171741817419174201742117422174231742417425174261742717428174291743017431174321743317434174351743617437174381743917440174411744217443174441744517446174471744817449174501745117452174531745417455174561745717458174591746017461174621746317464174651746617467174681746917470174711747217473174741747517476174771747817479174801748117482174831748417485174861748717488174891749017491174921749317494174951749617497174981749917500175011750217503175041750517506175071750817509175101751117512175131751417515175161751717518175191752017521175221752317524175251752617527175281752917530175311753217533175341753517536175371753817539175401754117542175431754417545175461754717548175491755017551175521755317554175551755617557175581755917560175611756217563175641756517566175671756817569175701757117572175731757417575175761757717578175791758017581175821758317584175851758617587175881758917590175911759217593175941759517596175971759817599176001760117602176031760417605176061760717608176091761017611176121761317614176151761617617176181761917620176211762217623176241762517626176271762817629176301763117632176331763417635176361763717638176391764017641176421764317644176451764617647176481764917650176511765217653176541765517656176571765817659176601766117662176631766417665176661766717668176691767017671176721767317674176751767617677176781767917680176811768217683176841768517686176871768817689176901769117692176931769417695176961769717698176991770017701177021770317704177051770617707177081770917710177111771217713177141771517716177171771817719177201772117722177231772417725177261772717728177291773017731177321773317734177351773617737177381773917740177411774217743177441774517746177471774817749177501775117752177531775417755177561775717758177591776017761177621776317764177651776617767177681776917770177711777217773177741777517776177771777817779177801778117782177831778417785177861778717788177891779017791177921779317794177951779617797177981779917800178011780217803178041780517806178071780817809178101781117812178131781417815178161781717818178191782017821178221782317824178251782617827178281782917830178311783217833178341783517836178371783817839178401784117842178431784417845178461784717848178491785017851178521785317854178551785617857178581785917860178611786217863178641786517866178671786817869178701787117872178731787417875178761787717878178791788017881178821788317884178851788617887178881788917890178911789217893178941789517896178971789817899179001790117902179031790417905179061790717908179091791017911179121791317914179151791617917179181791917920179211792217923179241792517926179271792817929179301793117932179331793417935179361793717938179391794017941179421794317944179451794617947179481794917950179511795217953179541795517956179571795817959179601796117962179631796417965179661796717968179691797017971179721797317974179751797617977179781797917980179811798217983179841798517986179871798817989179901799117992179931799417995179961799717998179991800018001180021800318004180051800618007180081800918010180111801218013180141801518016180171801818019180201802118022180231802418025180261802718028180291803018031180321803318034180351803618037180381803918040180411804218043180441804518046180471804818049180501805118052180531805418055180561805718058180591806018061180621806318064180651806618067180681806918070180711807218073180741807518076180771807818079180801808118082180831808418085180861808718088180891809018091180921809318094180951809618097180981809918100181011810218103181041810518106181071810818109181101811118112181131811418115181161811718118181191812018121181221812318124181251812618127181281812918130181311813218133181341813518136181371813818139181401814118142181431814418145181461814718148181491815018151181521815318154181551815618157181581815918160181611816218163181641816518166181671816818169181701817118172181731817418175181761817718178181791818018181181821818318184181851818618187181881818918190181911819218193181941819518196181971819818199182001820118202182031820418205182061820718208182091821018211182121821318214182151821618217182181821918220182211822218223182241822518226182271822818229182301823118232182331823418235182361823718238182391824018241182421824318244182451824618247182481824918250182511825218253182541825518256182571825818259182601826118262182631826418265182661826718268182691827018271182721827318274182751827618277182781827918280182811828218283182841828518286182871828818289182901829118292182931829418295182961829718298182991830018301183021830318304183051830618307183081830918310183111831218313183141831518316183171831818319183201832118322183231832418325183261832718328183291833018331183321833318334183351833618337183381833918340183411834218343183441834518346183471834818349183501835118352183531835418355183561835718358183591836018361183621836318364183651836618367183681836918370183711837218373183741837518376183771837818379183801838118382183831838418385183861838718388183891839018391183921839318394183951839618397183981839918400184011840218403184041840518406184071840818409184101841118412184131841418415184161841718418184191842018421184221842318424184251842618427184281842918430184311843218433184341843518436184371843818439184401844118442184431844418445184461844718448184491845018451184521845318454184551845618457184581845918460184611846218463184641846518466184671846818469184701847118472184731847418475184761847718478184791848018481184821848318484184851848618487184881848918490184911849218493184941849518496184971849818499185001850118502185031850418505185061850718508185091851018511185121851318514185151851618517185181851918520185211852218523185241852518526185271852818529185301853118532185331853418535185361853718538185391854018541185421854318544185451854618547185481854918550185511855218553185541855518556185571855818559185601856118562185631856418565185661856718568185691857018571185721857318574185751857618577185781857918580185811858218583185841858518586185871858818589185901859118592185931859418595185961859718598185991860018601186021860318604186051860618607186081860918610186111861218613186141861518616186171861818619186201862118622186231862418625186261862718628186291863018631186321863318634186351863618637186381863918640186411864218643186441864518646186471864818649186501865118652186531865418655186561865718658186591866018661186621866318664186651866618667186681866918670186711867218673186741867518676186771867818679186801868118682186831868418685186861868718688186891869018691186921869318694186951869618697186981869918700187011870218703187041870518706187071870818709187101871118712187131871418715187161871718718187191872018721187221872318724187251872618727187281872918730187311873218733187341873518736187371873818739187401874118742187431874418745187461874718748187491875018751187521875318754187551875618757187581875918760187611876218763187641876518766187671876818769187701877118772187731877418775187761877718778187791878018781187821878318784187851878618787187881878918790187911879218793187941879518796187971879818799 |
- /***************************************************************************
- ** **
- ** QCustomPlot, an easy to use, modern plotting widget for Qt **
- ** Copyright (C) 2011, 2012, 2013 Emanuel Eichhammer **
- ** **
- ** This program is free software: you can redistribute it and/or modify **
- ** it under the terms of the GNU General Public License as published by **
- ** the Free Software Foundation, either version 3 of the License, or **
- ** (at your option) any later version. **
- ** **
- ** This program is distributed in the hope that it will be useful, **
- ** but WITHOUT ANY WARRANTY; without even the implied warranty of **
- ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the **
- ** GNU General Public License for more details. **
- ** **
- ** You should have received a copy of the GNU General Public License **
- ** along with this program. If not, see http://www.gnu.org/licenses/. **
- ** **
- ****************************************************************************
- ** Author: Emanuel Eichhammer **
- ** Website/Contact: http://www.qcustomplot.com/ **
- ** Date: 04.11.13 **
- ** Version: 1.1.0 **
- ****************************************************************************/
-
- #include "qcustomplot.h"
-
-
-
-
- ////////////////////////////////////////////////////////////////////////////////////////////////////
- //////////////////// QCPPainter
- ////////////////////////////////////////////////////////////////////////////////////////////////////
-
- /*! \class QCPPainter
- \brief QPainter subclass used internally
-
- This internal class is used to provide some extended functionality e.g. for tweaking position
- consistency between antialiased and non-antialiased painting. Further it provides workarounds
- for QPainter quirks.
-
- \warning This class intentionally hides non-virtual functions of QPainter, e.g. setPen, save and
- restore. So while it is possible to pass a QCPPainter instance to a function that expects a
- QPainter pointer, some of the workarounds and tweaks will be unavailable to the function (because
- it will call the base class implementations of the functions actually hidden by QCPPainter).
- */
-
- /*!
- Creates a new QCPPainter instance and sets default values
- */
- QCPPainter::QCPPainter() :
- QPainter(),
- mModes(pmDefault),
- mIsAntialiasing(false)
- {
- // don't setRenderHint(QPainter::NonCosmeticDefautPen) here, because painter isn't active yet and
- // a call to begin() will follow
- }
-
- /*!
- Creates a new QCPPainter instance on the specified paint \a device and sets default values. Just
- like the analogous QPainter constructor, begins painting on \a device immediately.
-
- Like \ref begin, this method sets QPainter::NonCosmeticDefaultPen in Qt versions before Qt5.
- */
- QCPPainter::QCPPainter(QPaintDevice *device) :
- QPainter(device),
- mModes(pmDefault),
- mIsAntialiasing(false)
- {
- #if QT_VERSION < QT_VERSION_CHECK(5, 0, 0) // before Qt5, default pens used to be cosmetic if NonCosmeticDefaultPen flag isn't set. So we set it to get consistency across Qt versions.
- if (isActive())
- setRenderHint(QPainter::NonCosmeticDefaultPen);
- #endif
- }
-
- QCPPainter::~QCPPainter()
- {
- }
-
- /*!
- Sets the pen of the painter and applies certain fixes to it, depending on the mode of this
- QCPPainter.
-
- \note this function hides the non-virtual base class implementation.
- */
- void QCPPainter::setPen(const QPen &pen)
- {
- QPainter::setPen(pen);
- if (mModes.testFlag(pmNonCosmetic))
- makeNonCosmetic();
- }
-
- /*! \overload
-
- Sets the pen (by color) of the painter and applies certain fixes to it, depending on the mode of
- this QCPPainter.
-
- \note this function hides the non-virtual base class implementation.
- */
- void QCPPainter::setPen(const QColor &color)
- {
- QPainter::setPen(color);
- if (mModes.testFlag(pmNonCosmetic))
- makeNonCosmetic();
- }
-
- /*! \overload
-
- Sets the pen (by style) of the painter and applies certain fixes to it, depending on the mode of
- this QCPPainter.
-
- \note this function hides the non-virtual base class implementation.
- */
- void QCPPainter::setPen(Qt::PenStyle penStyle)
- {
- QPainter::setPen(penStyle);
- if (mModes.testFlag(pmNonCosmetic))
- makeNonCosmetic();
- }
-
- /*! \overload
-
- Works around a Qt bug introduced with Qt 4.8 which makes drawing QLineF unpredictable when
- antialiasing is disabled. Thus when antialiasing is disabled, it rounds the \a line to
- integer coordinates and then passes it to the original drawLine.
-
- \note this function hides the non-virtual base class implementation.
- */
- void QCPPainter::drawLine(const QLineF &line)
- {
- if (mIsAntialiasing || mModes.testFlag(pmVectorized))
- QPainter::drawLine(line);
- else
- QPainter::drawLine(line.toLine());
- }
-
- /*!
- Sets whether painting uses antialiasing or not. Use this method instead of using setRenderHint
- with QPainter::Antialiasing directly, as it allows QCPPainter to regain pixel exactness between
- antialiased and non-antialiased painting (Since Qt < 5.0 uses slightly different coordinate systems for
- AA/Non-AA painting).
- */
- void QCPPainter::setAntialiasing(bool enabled)
- {
- setRenderHint(QPainter::Antialiasing, enabled);
- if (mIsAntialiasing != enabled)
- {
- mIsAntialiasing = enabled;
- if (!mModes.testFlag(pmVectorized)) // antialiasing half-pixel shift only needed for rasterized outputs
- {
- if (mIsAntialiasing)
- translate(0.5, 0.5);
- else
- translate(-0.5, -0.5);
- }
- }
- }
-
- /*!
- Sets the mode of the painter. This controls whether the painter shall adjust its
- fixes/workarounds optimized for certain output devices.
- */
- void QCPPainter::setModes(QCPPainter::PainterModes modes)
- {
- mModes = modes;
- }
-
- /*!
- Sets the QPainter::NonCosmeticDefaultPen in Qt versions before Qt5 after beginning painting on \a
- device. This is necessary to get cosmetic pen consistency across Qt versions, because since Qt5,
- all pens are non-cosmetic by default, and in Qt4 this render hint must be set to get that
- behaviour.
-
- The Constructor \ref QCPPainter(QPaintDevice *device) which directly starts painting also sets
- the render hint as appropriate.
-
- \note this function hides the non-virtual base class implementation.
- */
- bool QCPPainter::begin(QPaintDevice *device)
- {
- bool result = QPainter::begin(device);
- #if QT_VERSION < QT_VERSION_CHECK(5, 0, 0) // before Qt5, default pens used to be cosmetic if NonCosmeticDefaultPen flag isn't set. So we set it to get consistency across Qt versions.
- if (result)
- setRenderHint(QPainter::NonCosmeticDefaultPen);
- #endif
- return result;
- }
-
- /*! \overload
-
- Sets the mode of the painter. This controls whether the painter shall adjust its
- fixes/workarounds optimized for certain output devices.
- */
- void QCPPainter::setMode(QCPPainter::PainterMode mode, bool enabled)
- {
- if (!enabled && mModes.testFlag(mode))
- mModes &= ~mode;
- else if (enabled && !mModes.testFlag(mode))
- mModes |= mode;
- }
-
- /*!
- Saves the painter (see QPainter::save). Since QCPPainter adds some new internal state to
- QPainter, the save/restore functions are reimplemented to also save/restore those members.
-
- \note this function hides the non-virtual base class implementation.
-
- \see restore
- */
- void QCPPainter::save()
- {
- mAntialiasingStack.push(mIsAntialiasing);
- QPainter::save();
- }
-
- /*!
- Restores the painter (see QPainter::restore). Since QCPPainter adds some new internal state to
- QPainter, the save/restore functions are reimplemented to also save/restore those members.
-
- \note this function hides the non-virtual base class implementation.
-
- \see save
- */
- void QCPPainter::restore()
- {
- if (!mAntialiasingStack.isEmpty())
- mIsAntialiasing = mAntialiasingStack.pop();
- else
- qDebug() << Q_FUNC_INFO << "Unbalanced save/restore";
- QPainter::restore();
- }
-
- /*!
- Changes the pen width to 1 if it currently is 0. This function is called in the \ref setPen
- overrides when the \ref pmNonCosmetic mode is set.
- */
- void QCPPainter::makeNonCosmetic()
- {
- if (qFuzzyIsNull(pen().widthF()))
- {
- QPen p = pen();
- p.setWidth(1);
- QPainter::setPen(p);
- }
- }
-
-
- ////////////////////////////////////////////////////////////////////////////////////////////////////
- //////////////////// QCPScatterStyle
- ////////////////////////////////////////////////////////////////////////////////////////////////////
-
- /*! \class QCPScatterStyle
- \brief Represents the visual appearance of scatter points
-
- This class holds information about shape, color and size of scatter points. In plottables like
- QCPGraph it is used to store how scatter points shall be drawn. For example, \ref
- QCPGraph::setScatterStyle takes a QCPScatterStyle instance.
-
- A scatter style consists of a shape (\ref setShape), a line color (\ref setPen) and possibly a
- fill (\ref setBrush), if the shape provides a fillable area. Further, the size of the shape can
- be controlled with \ref setSize.
-
- \section QCPScatterStyle-defining Specifying a scatter style
-
- You can set all these configurations either by calling the respective functions on an instance:
- \code
- QCPScatterStyle myScatter;
- myScatter.setShape(QCPScatterStyle::ssCircle);
- myScatter.setPen(Qt::blue);
- myScatter.setBrush(Qt::white);
- myScatter.setSize(5);
- customPlot->graph(0)->setScatterStyle(myScatter);
- \endcode
-
- Or you can use one of the various constructors that take different parameter combinations, making
- it easy to specify a scatter style in a single call, like so:
- \code
- customPlot->graph(0)->setScatterStyle(QCPScatterStyle(QCPScatterStyle::ssCircle, Qt::blue, Qt::white, 5));
- \endcode
-
- \section QCPScatterStyle-undefinedpen Leaving the color/pen up to the plottable
-
- There are two constructors which leave the pen undefined: \ref QCPScatterStyle() and \ref
- QCPScatterStyle(ScatterShape shape, double size). If those constructors are used, a call to \ref
- isPenDefined will return false. It leads to scatter points that inherit the pen from the
- plottable that uses the scatter style. Thus, if such a scatter style is passed to QCPGraph, the line
- color of the graph (\ref QCPGraph::setPen) will be used by the scatter points. This makes
- it very convenient to set up typical scatter settings:
-
- \code
- customPlot->graph(0)->setScatterStyle(QCPScatterStyle::ssPlus);
- \endcode
-
- Notice that it wasn't even necessary to explicitly call a QCPScatterStyle constructor. This works
- because QCPScatterStyle provides a constructor that can transform a \ref ScatterShape directly
- into a QCPScatterStyle instance (that's the \ref QCPScatterStyle(ScatterShape shape, double size)
- constructor with a default for \a size). In those cases, C++ allows directly supplying a \ref
- ScatterShape, where actually a QCPScatterStyle is expected.
-
- \section QCPScatterStyle-custompath-and-pixmap Custom shapes and pixmaps
-
- QCPScatterStyle supports drawing custom shapes and arbitrary pixmaps as scatter points.
-
- For custom shapes, you can provide a QPainterPath with the desired shape to the \ref
- setCustomPath function or call the constructor that takes a painter path. The scatter shape will
- automatically be set to \ref ssCustom.
-
- For pixmaps, you call \ref setPixmap with the desired QPixmap. Alternatively you can use the
- constructor that takes a QPixmap. The scatter shape will automatically be set to \ref ssPixmap.
- Note that \ref setSize does not influence the appearance of the pixmap.
- */
-
- /* start documentation of inline functions */
-
- /*! \fn bool QCPScatterStyle::isNone() const
-
- Returns whether the scatter shape is \ref ssNone.
-
- \see setShape
- */
-
- /*! \fn bool QCPScatterStyle::isPenDefined() const
-
- Returns whether a pen has been defined for this scatter style.
-
- The pen is undefined if a constructor is called that does not carry \a pen as parameter. Those are
- \ref QCPScatterStyle() and \ref QCPScatterStyle(ScatterShape shape, double size). If the pen is
- left undefined, the scatter color will be inherited from the plottable that uses this scatter
- style.
-
- \see setPen
- */
-
- /* end documentation of inline functions */
-
- /*!
- Creates a new QCPScatterStyle instance with size set to 6. No shape, pen or brush is defined.
-
- Since the pen is undefined (\ref isPenDefined returns false), the scatter color will be inherited
- from the plottable that uses this scatter style.
- */
- QCPScatterStyle::QCPScatterStyle() :
- mSize(6),
- mShape(ssNone),
- mPen(Qt::NoPen),
- mBrush(Qt::NoBrush),
- mPenDefined(false)
- {
- }
-
- /*!
- Creates a new QCPScatterStyle instance with shape set to \a shape and size to \a size. No pen or
- brush is defined.
-
- Since the pen is undefined (\ref isPenDefined returns false), the scatter color will be inherited
- from the plottable that uses this scatter style.
- */
- QCPScatterStyle::QCPScatterStyle(ScatterShape shape, double size) :
- mSize(size),
- mShape(shape),
- mPen(Qt::NoPen),
- mBrush(Qt::NoBrush),
- mPenDefined(false)
- {
- }
-
- /*!
- Creates a new QCPScatterStyle instance with shape set to \a shape, the pen color set to \a color,
- and size to \a size. No brush is defined, i.e. the scatter point will not be filled.
- */
- QCPScatterStyle::QCPScatterStyle(ScatterShape shape, const QColor &color, double size) :
- mSize(size),
- mShape(shape),
- mPen(QPen(color)),
- mBrush(Qt::NoBrush),
- mPenDefined(true)
- {
- }
-
- /*!
- Creates a new QCPScatterStyle instance with shape set to \a shape, the pen color set to \a color,
- the brush color to \a fill (with a solid pattern), and size to \a size.
- */
- QCPScatterStyle::QCPScatterStyle(ScatterShape shape, const QColor &color, const QColor &fill, double size) :
- mSize(size),
- mShape(shape),
- mPen(QPen(color)),
- mBrush(QBrush(fill)),
- mPenDefined(true)
- {
- }
-
- /*!
- Creates a new QCPScatterStyle instance with shape set to \a shape, the pen set to \a pen, the
- brush to \a brush, and size to \a size.
-
- \warning In some cases it might be tempting to directly use a pen style like <tt>Qt::NoPen</tt> as \a pen
- and a color like <tt>Qt::blue</tt> as \a brush. Notice however, that the corresponding call\n
- <tt>QCPScatterStyle(QCPScatterShape::ssCircle, Qt::NoPen, Qt::blue, 5)</tt>\n
- doesn't necessarily lead C++ to use this constructor in some cases, but might mistake
- <tt>Qt::NoPen</tt> for a QColor and use the
- \ref QCPScatterStyle(ScatterShape shape, const QColor &color, const QColor &fill, double size)
- constructor instead (which will lead to an unexpected look of the scatter points). To prevent
- this, be more explicit with the parameter types. For example, use <tt>QBrush(Qt::blue)</tt>
- instead of just <tt>Qt::blue</tt>, to clearly point out to the compiler that this constructor is
- wanted.
- */
- QCPScatterStyle::QCPScatterStyle(ScatterShape shape, const QPen &pen, const QBrush &brush, double size) :
- mSize(size),
- mShape(shape),
- mPen(pen),
- mBrush(brush),
- mPenDefined(pen.style() != Qt::NoPen)
- {
- }
-
- /*!
- Creates a new QCPScatterStyle instance which will show the specified \a pixmap. The scatter shape
- is set to \ref ssPixmap.
- */
- QCPScatterStyle::QCPScatterStyle(const QPixmap &pixmap) :
- mSize(5),
- mShape(ssPixmap),
- mPen(Qt::NoPen),
- mBrush(Qt::NoBrush),
- mPixmap(pixmap),
- mPenDefined(false)
- {
- }
-
- /*!
- Creates a new QCPScatterStyle instance with a custom shape that is defined via \a customPath. The
- scatter shape is set to \ref ssCustom.
-
- The custom shape line will be drawn with \a pen and filled with \a brush. The size has a slightly
- different meaning than for built-in scatter points: The custom path will be drawn scaled by a
- factor of \a size/6.0. Since the default \a size is 6, the custom path will appear at a its
- natural size by default. To double the size of the path for example, set \a size to 12.
- */
- QCPScatterStyle::QCPScatterStyle(const QPainterPath &customPath, const QPen &pen, const QBrush &brush, double size) :
- mSize(size),
- mShape(ssCustom),
- mPen(pen),
- mBrush(brush),
- mCustomPath(customPath),
- mPenDefined(false)
- {
- }
-
- /*!
- Sets the size (pixel diameter) of the drawn scatter points to \a size.
-
- \see setShape
- */
- void QCPScatterStyle::setSize(double size)
- {
- mSize = size;
- }
-
- /*!
- Sets the shape to \a shape.
-
- Note that the calls \ref setPixmap and \ref setCustomPath automatically set the shape to \ref
- ssPixmap and \ref ssCustom, respectively.
-
- \see setSize
- */
- void QCPScatterStyle::setShape(QCPScatterStyle::ScatterShape shape)
- {
- mShape = shape;
- }
-
- /*!
- Sets the pen that will be used to draw scatter points to \a pen.
-
- If the pen was previously undefined (see \ref isPenDefined), the pen is considered defined after
- a call to this function, even if \a pen is <tt>Qt::NoPen</tt>.
-
- \see setBrush
- */
- void QCPScatterStyle::setPen(const QPen &pen)
- {
- mPenDefined = true;
- mPen = pen;
- }
-
- /*!
- Sets the brush that will be used to fill scatter points to \a brush. Note that not all scatter
- shapes have fillable areas. For example, \ref ssPlus does not while \ref ssCircle does.
-
- \see setPen
- */
- void QCPScatterStyle::setBrush(const QBrush &brush)
- {
- mBrush = brush;
- }
-
- /*!
- Sets the pixmap that will be drawn as scatter point to \a pixmap.
-
- Note that \ref setSize does not influence the appearance of the pixmap.
-
- The scatter shape is automatically set to \ref ssPixmap.
- */
- void QCPScatterStyle::setPixmap(const QPixmap &pixmap)
- {
- setShape(ssPixmap);
- mPixmap = pixmap;
- }
-
- /*!
- Sets the custom shape that will be drawn as scatter point to \a customPath.
-
- The scatter shape is automatically set to \ref ssCustom.
- */
- void QCPScatterStyle::setCustomPath(const QPainterPath &customPath)
- {
- setShape(ssCustom);
- mCustomPath = customPath;
- }
-
- /*!
- Applies the pen and the brush of this scatter style to \a painter. If this scatter style has an
- undefined pen (\ref isPenDefined), sets the pen of \a painter to \a defaultPen instead.
-
- This function is used by plottables (or any class that wants to draw scatters) just before a
- number of scatters with this style shall be drawn with the \a painter.
-
- \see drawShape
- */
- void QCPScatterStyle::applyTo(QCPPainter *painter, const QPen &defaultPen) const
- {
- painter->setPen(mPenDefined ? mPen : defaultPen);
- painter->setBrush(mBrush);
- }
-
- /*!
- Draws the scatter shape with \a painter at position \a pos.
-
- This function does not modify the pen or the brush on the painter, as \ref applyTo is meant to be
- called before scatter points are drawn with \ref drawShape.
-
- \see applyTo
- */
- void QCPScatterStyle::drawShape(QCPPainter *painter, QPointF pos) const
- {
- drawShape(painter, pos.x(), pos.y());
- }
-
- /*! \overload
- Draws the scatter shape with \a painter at position \a x and \a y.
- */
- void QCPScatterStyle::drawShape(QCPPainter *painter, double x, double y) const
- {
- double w = mSize/2.0;
- switch (mShape)
- {
- case ssNone: break;
- case ssDot:
- {
- painter->drawLine(QPointF(x, y), QPointF(x+0.0001, y));
- break;
- }
- case ssCross:
- {
- painter->drawLine(QLineF(x-w, y-w, x+w, y+w));
- painter->drawLine(QLineF(x-w, y+w, x+w, y-w));
- break;
- }
- case ssPlus:
- {
- painter->drawLine(QLineF(x-w, y, x+w, y));
- painter->drawLine(QLineF( x, y+w, x, y-w));
- break;
- }
- case ssCircle:
- {
- painter->drawEllipse(QPointF(x , y), w, w);
- break;
- }
- case ssDisc:
- {
- QBrush b = painter->brush();
- painter->setBrush(painter->pen().color());
- painter->drawEllipse(QPointF(x , y), w, w);
- painter->setBrush(b);
- break;
- }
- case ssSquare:
- {
- painter->drawRect(QRectF(x-w, y-w, mSize, mSize));
- break;
- }
- case ssDiamond:
- {
- painter->drawLine(QLineF(x-w, y, x, y-w));
- painter->drawLine(QLineF( x, y-w, x+w, y));
- painter->drawLine(QLineF(x+w, y, x, y+w));
- painter->drawLine(QLineF( x, y+w, x-w, y));
- break;
- }
- case ssStar:
- {
- painter->drawLine(QLineF(x-w, y, x+w, y));
- painter->drawLine(QLineF( x, y+w, x, y-w));
- painter->drawLine(QLineF(x-w*0.707, y-w*0.707, x+w*0.707, y+w*0.707));
- painter->drawLine(QLineF(x-w*0.707, y+w*0.707, x+w*0.707, y-w*0.707));
- break;
- }
- case ssTriangle:
- {
- painter->drawLine(QLineF(x-w, y+0.755*w, x+w, y+0.755*w));
- painter->drawLine(QLineF(x+w, y+0.755*w, x, y-0.977*w));
- painter->drawLine(QLineF( x, y-0.977*w, x-w, y+0.755*w));
- break;
- }
- case ssTriangleInverted:
- {
- painter->drawLine(QLineF(x-w, y-0.755*w, x+w, y-0.755*w));
- painter->drawLine(QLineF(x+w, y-0.755*w, x, y+0.977*w));
- painter->drawLine(QLineF( x, y+0.977*w, x-w, y-0.755*w));
- break;
- }
- case ssCrossSquare:
- {
- painter->drawLine(QLineF(x-w, y-w, x+w*0.95, y+w*0.95));
- painter->drawLine(QLineF(x-w, y+w*0.95, x+w*0.95, y-w));
- painter->drawRect(QRectF(x-w, y-w, mSize, mSize));
- break;
- }
- case ssPlusSquare:
- {
- painter->drawLine(QLineF(x-w, y, x+w*0.95, y));
- painter->drawLine(QLineF( x, y+w, x, y-w));
- painter->drawRect(QRectF(x-w, y-w, mSize, mSize));
- break;
- }
- case ssCrossCircle:
- {
- painter->drawLine(QLineF(x-w*0.707, y-w*0.707, x+w*0.670, y+w*0.670));
- painter->drawLine(QLineF(x-w*0.707, y+w*0.670, x+w*0.670, y-w*0.707));
- painter->drawEllipse(QPointF(x, y), w, w);
- break;
- }
- case ssPlusCircle:
- {
- painter->drawLine(QLineF(x-w, y, x+w, y));
- painter->drawLine(QLineF( x, y+w, x, y-w));
- painter->drawEllipse(QPointF(x, y), w, w);
- break;
- }
- case ssPeace:
- {
- painter->drawLine(QLineF(x, y-w, x, y+w));
- painter->drawLine(QLineF(x, y, x-w*0.707, y+w*0.707));
- painter->drawLine(QLineF(x, y, x+w*0.707, y+w*0.707));
- painter->drawEllipse(QPointF(x, y), w, w);
- break;
- }
- case ssPixmap:
- {
- painter->drawPixmap(x-mPixmap.width()*0.5, y-mPixmap.height()*0.5, mPixmap);
- break;
- }
- case ssCustom:
- {
- QTransform oldTransform = painter->transform();
- painter->translate(x, y);
- painter->scale(mSize/6.0, mSize/6.0);
- painter->drawPath(mCustomPath);
- painter->setTransform(oldTransform);
- break;
- }
- }
- }
-
-
- ////////////////////////////////////////////////////////////////////////////////////////////////////
- //////////////////// QCPLayer
- ////////////////////////////////////////////////////////////////////////////////////////////////////
-
- /*! \class QCPLayer
- \brief A layer that may contain objects, to control the rendering order
-
- The Layering system of QCustomPlot is the mechanism to control the rendering order of the
- elements inside the plot.
-
- It is based on the two classes QCPLayer and QCPLayerable. QCustomPlot holds an ordered list of
- one or more instances of QCPLayer (see QCustomPlot::addLayer, QCustomPlot::layer,
- QCustomPlot::moveLayer, etc.). When replotting, QCustomPlot goes through the list of layers
- bottom to top and successively draws the layerables of the layers.
-
- A QCPLayer contains an ordered list of QCPLayerable instances. QCPLayerable is an abstract base
- class from which almost all visible objects derive, like axes, grids, graphs, items, etc.
-
- Initially, QCustomPlot has five layers: "background", "grid", "main", "axes" and "legend" (in
- that order). The top two layers "axes" and "legend" contain the default axes and legend, so they
- will be drawn on top. In the middle, there is the "main" layer. It is initially empty and set as
- the current layer (see QCustomPlot::setCurrentLayer). This means, all new plottables, items etc.
- are created on this layer by default. Then comes the "grid" layer which contains the QCPGrid
- instances (which belong tightly to QCPAxis, see \ref QCPAxis::grid). The Axis rect background
- shall be drawn behind everything else, thus the default QCPAxisRect instance is placed on the
- "background" layer. Of course, the layer affiliation of the individual objects can be changed as
- required (\ref QCPLayerable::setLayer).
-
- Controlling the ordering of objects is easy: Create a new layer in the position you want it to
- be, e.g. above "main", with QCustomPlot::addLayer. Then set the current layer with
- QCustomPlot::setCurrentLayer to that new layer and finally create the objects normally. They will
- be placed on the new layer automatically, due to the current layer setting. Alternatively you
- could have also ignored the current layer setting and just moved the objects with
- QCPLayerable::setLayer to the desired layer after creating them.
-
- It is also possible to move whole layers. For example, If you want the grid to be shown in front
- of all plottables/items on the "main" layer, just move it above "main" with
- QCustomPlot::moveLayer.
-
- The rendering order within one layer is simply by order of creation or insertion. The item
- created last (or added last to the layer), is drawn on top of all other objects on that layer.
-
- When a layer is deleted, the objects on it are not deleted with it, but fall on the layer below
- the deleted layer, see QCustomPlot::removeLayer.
- */
-
- /* start documentation of inline functions */
-
- /*! \fn QList<QCPLayerable*> QCPLayer::children() const
-
- Returns a list of all layerables on this layer. The order corresponds to the rendering order:
- layerables with higher indices are drawn above layerables with lower indices.
- */
-
- /*! \fn int QCPLayer::index() const
-
- Returns the index this layer has in the QCustomPlot. The index is the integer number by which this layer can be
- accessed via \ref QCustomPlot::layer.
-
- Layers with higher indices will be drawn above layers with lower indices.
- */
-
- /* end documentation of inline functions */
-
- /*!
- Creates a new QCPLayer instance.
-
- Normally you shouldn't directly instantiate layers, use \ref QCustomPlot::addLayer instead.
-
- \warning It is not checked that \a layerName is actually a unique layer name in \a parentPlot.
- This check is only performed by \ref QCustomPlot::addLayer.
- */
- QCPLayer::QCPLayer(QCustomPlot *parentPlot, const QString &layerName) :
- QObject(parentPlot),
- mParentPlot(parentPlot),
- mName(layerName),
- mIndex(-1) // will be set to a proper value by the QCustomPlot layer creation function
- {
- // Note: no need to make sure layerName is unique, because layer
- // management is done with QCustomPlot functions.
- }
-
- QCPLayer::~QCPLayer()
- {
- // If child layerables are still on this layer, detach them, so they don't try to reach back to this
- // then invalid layer once they get deleted/moved themselves. This only happens when layers are deleted
- // directly, like in the QCustomPlot destructor. (The regular layer removal procedure for the user is to
- // call QCustomPlot::removeLayer, which moves all layerables off this layer before deleting it.)
-
- while (!mChildren.isEmpty())
- mChildren.last()->setLayer(0); // removes itself from mChildren via removeChild()
-
- if (mParentPlot->currentLayer() == this)
- qDebug() << Q_FUNC_INFO << "The parent plot's mCurrentLayer will be a dangling pointer. Should have been set to a valid layer or 0 beforehand.";
- }
-
- /*! \internal
-
- Adds the \a layerable to the list of this layer. If \a prepend is set to true, the layerable will
- be prepended to the list, i.e. be drawn beneath the other layerables already in the list.
-
- This function does not change the \a mLayer member of \a layerable to this layer. (Use
- QCPLayerable::setLayer to change the layer of an object, not this function.)
-
- \see removeChild
- */
- void QCPLayer::addChild(QCPLayerable *layerable, bool prepend)
- {
- if (!mChildren.contains(layerable))
- {
- if (prepend)
- mChildren.prepend(layerable);
- else
- mChildren.append(layerable);
- } else
- qDebug() << Q_FUNC_INFO << "layerable is already child of this layer" << reinterpret_cast<quintptr>(layerable);
- }
-
- /*! \internal
-
- Removes the \a layerable from the list of this layer.
-
- This function does not change the \a mLayer member of \a layerable. (Use QCPLayerable::setLayer
- to change the layer of an object, not this function.)
-
- \see addChild
- */
- void QCPLayer::removeChild(QCPLayerable *layerable)
- {
- if (!mChildren.removeOne(layerable))
- qDebug() << Q_FUNC_INFO << "layerable is not child of this layer" << reinterpret_cast<quintptr>(layerable);
- }
-
-
- ////////////////////////////////////////////////////////////////////////////////////////////////////
- //////////////////// QCPLayerable
- ////////////////////////////////////////////////////////////////////////////////////////////////////
-
- /*! \class QCPLayerable
- \brief Base class for all drawable objects
-
- This is the abstract base class most visible objects derive from, e.g. plottables, axes, grid
- etc.
-
- Every layerable is on a layer (QCPLayer) which allows controlling the rendering order by stacking
- the layers accordingly.
-
- For details about the layering mechanism, see the QCPLayer documentation.
- */
-
- /* start documentation of inline functions */
-
- /*! \fn QCPLayerable *QCPLayerable::parentLayerable() const
-
- Returns the parent layerable of this layerable. The parent layerable is used to provide
- visibility hierarchies in conjunction with the method \ref realVisibility. This way, layerables
- only get drawn if their parent layerables are visible, too.
-
- Note that a parent layerable is not necessarily also the QObject parent for memory management.
- Further, a layerable doesn't always have a parent layerable, so this function may return 0.
-
- A parent layerable is set implicitly with when placed inside layout elements and doesn't need to be
- set manually by the user.
- */
-
- /* end documentation of inline functions */
- /* start documentation of pure virtual functions */
-
- /*! \fn virtual void QCPLayerable::applyDefaultAntialiasingHint(QCPPainter *painter) const = 0
- \internal
-
- This function applies the default antialiasing setting to the specified \a painter, using the
- function \ref applyAntialiasingHint. It is the antialiasing state the painter is put in, when
- \ref draw is called on the layerable. If the layerable has multiple entities whose antialiasing
- setting may be specified individually, this function should set the antialiasing state of the
- most prominent entity. In this case however, the \ref draw function usually calls the specialized
- versions of this function before drawing each entity, effectively overriding the setting of the
- default antialiasing hint.
-
- <b>First example:</b> QCPGraph has multiple entities that have an antialiasing setting: The graph
- line, fills, scatters and error bars. Those can be configured via QCPGraph::setAntialiased,
- QCPGraph::setAntialiasedFill, QCPGraph::setAntialiasedScatters etc. Consequently, there isn't
- only the QCPGraph::applyDefaultAntialiasingHint function (which corresponds to the graph line's
- antialiasing), but specialized ones like QCPGraph::applyFillAntialiasingHint and
- QCPGraph::applyScattersAntialiasingHint. So before drawing one of those entities, QCPGraph::draw
- calls the respective specialized applyAntialiasingHint function.
-
- <b>Second example:</b> QCPItemLine consists only of a line so there is only one antialiasing
- setting which can be controlled with QCPItemLine::setAntialiased. (This function is inherited by
- all layerables. The specialized functions, as seen on QCPGraph, must be added explicitly to the
- respective layerable subclass.) Consequently it only has the normal
- QCPItemLine::applyDefaultAntialiasingHint. The \ref QCPItemLine::draw function doesn't need to
- care about setting any antialiasing states, because the default antialiasing hint is already set
- on the painter when the \ref draw function is called, and that's the state it wants to draw the
- line with.
- */
-
- /*! \fn virtual void QCPLayerable::draw(QCPPainter *painter) const = 0
- \internal
-
- This function draws the layerable with the specified \a painter. It is only called by
- QCustomPlot, if the layerable is visible (\ref setVisible).
-
- Before this function is called, the painter's antialiasing state is set via \ref
- applyDefaultAntialiasingHint, see the documentation there. Further, the clipping rectangle was
- set to \ref clipRect.
- */
-
- /* end documentation of pure virtual functions */
-
- /*!
- Creates a new QCPLayerable instance.
-
- Since QCPLayerable is an abstract base class, it can't be instantiated directly. Use one of the
- derived classes.
-
- If \a plot is provided, it automatically places itself on the layer named \a targetLayer. If \a
- targetLayer is an empty string, it places itself on the current layer of the plot (see \ref
- QCustomPlot::setCurrentLayer).
-
- It is possible to provide 0 as \a plot. In that case, you should assign a parent plot at a later
- time with \ref initializeParentPlot.
-
- The layerable's parent layerable is set to \a parentLayerable, if provided. Direct layerable parents
- are mainly used to control visibility in a hierarchy of layerables. This means a layerable is
- only drawn, if all its ancestor layerables are also visible. Note that \a parentLayerable does
- not become the QObject-parent (for memory management) of this layerable, \a plot does.
- */
- QCPLayerable::QCPLayerable(QCustomPlot *plot, QString targetLayer, QCPLayerable *parentLayerable) :
- QObject(plot),
- mVisible(true),
- mParentPlot(plot),
- mParentLayerable(parentLayerable),
- mLayer(0),
- mAntialiased(true)
- {
- if (mParentPlot)
- {
- if (targetLayer.isEmpty())
- setLayer(mParentPlot->currentLayer());
- else if (!setLayer(targetLayer))
- qDebug() << Q_FUNC_INFO << "setting QCPlayerable initial layer to" << targetLayer << "failed.";
- }
- }
-
- QCPLayerable::~QCPLayerable()
- {
- if (mLayer)
- {
- mLayer->removeChild(this);
- mLayer = 0;
- }
- }
-
- /*!
- Sets the visibility of this layerable object. If an object is not visible, it will not be drawn
- on the QCustomPlot surface, and user interaction with it (e.g. click and selection) is not
- possible.
- */
- void QCPLayerable::setVisible(bool on)
- {
- mVisible = on;
- }
-
- /*!
- Sets the \a layer of this layerable object. The object will be placed on top of the other objects
- already on \a layer.
-
- Returns true on success, i.e. if \a layer is a valid layer.
- */
- bool QCPLayerable::setLayer(QCPLayer *layer)
- {
- return moveToLayer(layer, false);
- }
-
- /*! \overload
- Sets the layer of this layerable object by name
-
- Returns true on success, i.e. if \a layerName is a valid layer name.
- */
- bool QCPLayerable::setLayer(const QString &layerName)
- {
- if (!mParentPlot)
- {
- qDebug() << Q_FUNC_INFO << "no parent QCustomPlot set";
- return false;
- }
- if (QCPLayer *layer = mParentPlot->layer(layerName))
- {
- return setLayer(layer);
- } else
- {
- qDebug() << Q_FUNC_INFO << "there is no layer with name" << layerName;
- return false;
- }
- }
-
- /*!
- Sets whether this object will be drawn antialiased or not.
-
- Note that antialiasing settings may be overridden by QCustomPlot::setAntialiasedElements and
- QCustomPlot::setNotAntialiasedElements.
- */
- void QCPLayerable::setAntialiased(bool enabled)
- {
- mAntialiased = enabled;
- }
-
- /*!
- Returns whether this layerable is visible, taking possible direct layerable parent visibility
- into account. This is the method that is consulted to decide whether a layerable shall be drawn
- or not.
-
- If this layerable has a direct layerable parent (usually set via hierarchies implemented in
- subclasses, like in the case of QCPLayoutElement), this function returns true only if this
- layerable has its visibility set to true and the parent layerable's \ref realVisibility returns
- true.
-
- If this layerable doesn't have a direct layerable parent, returns the state of this layerable's
- visibility.
- */
- bool QCPLayerable::realVisibility() const
- {
- return mVisible && (!mParentLayerable || mParentLayerable.data()->realVisibility());
- }
-
- /*!
- This function is used to decide whether a click hits a layerable object or not.
-
- \a pos is a point in pixel coordinates on the QCustomPlot surface. This function returns the
- shortest pixel distance of this point to the object. If the object is either invisible or the
- distance couldn't be determined, -1.0 is returned. Further, if \a onlySelectable is true and the
- object is not selectable, -1.0 is returned, too.
-
- If the item is represented not by single lines but by an area like QCPItemRect or QCPItemText, a
- click inside the area returns a constant value greater zero (typically the selectionTolerance of
- the parent QCustomPlot multiplied by 0.99). If the click lies outside the area, this function
- returns -1.0.
-
- Providing a constant value for area objects allows selecting line objects even when they are
- obscured by such area objects, by clicking close to the lines (i.e. closer than
- 0.99*selectionTolerance).
-
- The actual setting of the selection state is not done by this function. This is handled by the
- parent QCustomPlot when the mouseReleaseEvent occurs, and the finally selected object is notified
- via the selectEvent/deselectEvent methods.
-
- \a details is an optional output parameter. Every layerable subclass may place any information
- in \a details. This information will be passed to \ref selectEvent when the parent QCustomPlot
- decides on the basis of this selectTest call, that the object was successfully selected. The
- subsequent call to \ref selectEvent will carry the \a details. This is useful for multi-part
- objects (like QCPAxis). This way, a possibly complex calculation to decide which part was clicked
- is only done once in \ref selectTest. The result (i.e. the actually clicked part) can then be
- placed in \a details. So in the subsequent \ref selectEvent, the decision which part was
- selected doesn't have to be done a second time for a single selection operation.
-
- You may pass 0 as \a details to indicate that you are not interested in those selection details.
-
- \see selectEvent, deselectEvent, QCustomPlot::setInteractions
- */
- double QCPLayerable::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const
- {
- Q_UNUSED(pos)
- Q_UNUSED(onlySelectable)
- Q_UNUSED(details)
- return -1.0;
- }
-
- /*! \internal
-
- Sets the parent plot of this layerable. Use this function once to set the parent plot if you have
- passed 0 in the constructor. It can not be used to move a layerable from one QCustomPlot to
- another one.
-
- Note that, unlike when passing a non-null parent plot in the constructor, this function does not
- make \a parentPlot the QObject-parent of this layerable. If you want this, call
- QObject::setParent(\a parentPlot) in addition to this function.
-
- Further, you will probably want to set a layer (\ref setLayer) after calling this function, to
- make the layerable appear on the QCustomPlot.
-
- The parent plot change will be propagated to subclasses via a call to \ref parentPlotInitialized
- so they can react accordingly (e.g. also initialize the parent plot of child layerables, like
- QCPLayout does).
- */
- void QCPLayerable::initializeParentPlot(QCustomPlot *parentPlot)
- {
- if (mParentPlot)
- {
- qDebug() << Q_FUNC_INFO << "called with mParentPlot already initialized";
- return;
- }
-
- if (!parentPlot)
- qDebug() << Q_FUNC_INFO << "called with parentPlot zero";
-
- mParentPlot = parentPlot;
- parentPlotInitialized(mParentPlot);
- }
-
- /*! \internal
-
- Sets the parent layerable of this layerable to \a parentLayerable. Note that \a parentLayerable does not
- become the QObject-parent (for memory management) of this layerable.
-
- The parent layerable has influence on the return value of the \ref realVisibility method. Only
- layerables with a fully visible parent tree will return true for \ref realVisibility, and thus be
- drawn.
-
- \see realVisibility
- */
- void QCPLayerable::setParentLayerable(QCPLayerable *parentLayerable)
- {
- mParentLayerable = parentLayerable;
- }
-
- /*! \internal
-
- Moves this layerable object to \a layer. If \a prepend is true, this object will be prepended to
- the new layer's list, i.e. it will be drawn below the objects already on the layer. If it is
- false, the object will be appended.
-
- Returns true on success, i.e. if \a layer is a valid layer.
- */
- bool QCPLayerable::moveToLayer(QCPLayer *layer, bool prepend)
- {
- if (layer && !mParentPlot)
- {
- qDebug() << Q_FUNC_INFO << "no parent QCustomPlot set";
- return false;
- }
- if (layer && layer->parentPlot() != mParentPlot)
- {
- qDebug() << Q_FUNC_INFO << "layer" << layer->name() << "is not in same QCustomPlot as this layerable";
- return false;
- }
-
- if (mLayer)
- mLayer->removeChild(this);
- mLayer = layer;
- if (mLayer)
- mLayer->addChild(this, prepend);
- return true;
- }
-
- /*! \internal
-
- Sets the QCPainter::setAntialiasing state on the provided \a painter, depending on the \a
- localAntialiased value as well as the overrides \ref QCustomPlot::setAntialiasedElements and \ref
- QCustomPlot::setNotAntialiasedElements. Which override enum this function takes into account is
- controlled via \a overrideElement.
- */
- void QCPLayerable::applyAntialiasingHint(QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
- {
- if (mParentPlot && mParentPlot->notAntialiasedElements().testFlag(overrideElement))
- painter->setAntialiasing(false);
- else if (mParentPlot && mParentPlot->antialiasedElements().testFlag(overrideElement))
- painter->setAntialiasing(true);
- else
- painter->setAntialiasing(localAntialiased);
- }
-
- /*! \internal
-
- This function is called by \ref initializeParentPlot, to allow subclasses to react on the setting
- of a parent plot. This is the case when 0 was passed as parent plot in the constructor, and the
- parent plot is set at a later time.
-
- For example, QCPLayoutElement/QCPLayout hierarchies may be created independently of any
- QCustomPlot at first. When they are then added to a layout inside the QCustomPlot, the top level
- element of the hierarchy gets its parent plot initialized with \ref initializeParentPlot. To
- propagate the parent plot to all the children of the hierarchy, the top level element then uses
- this function to pass the parent plot on to its child elements.
-
- The default implementation does nothing.
-
- \see initializeParentPlot
- */
- void QCPLayerable::parentPlotInitialized(QCustomPlot *parentPlot)
- {
- Q_UNUSED(parentPlot)
- }
-
- /*! \internal
-
- Returns the selection category this layerable shall belong to. The selection category is used in
- conjunction with \ref QCustomPlot::setInteractions to control which objects are selectable and
- which aren't.
-
- Subclasses that don't fit any of the normal \ref QCP::Interaction values can use \ref
- QCP::iSelectOther. This is what the default implementation returns.
-
- \see QCustomPlot::setInteractions
- */
- QCP::Interaction QCPLayerable::selectionCategory() const
- {
- return QCP::iSelectOther;
- }
-
- /*! \internal
-
- Returns the clipping rectangle of this layerable object. By default, this is the viewport of the
- parent QCustomPlot. Specific subclasses may reimplement this function to provide different
- clipping rects.
-
- The returned clipping rect is set on the painter before the draw function of the respective
- object is called.
- */
- QRect QCPLayerable::clipRect() const
- {
- if (mParentPlot)
- return mParentPlot->viewport();
- else
- return QRect();
- }
-
- /*! \internal
-
- This event is called when the layerable shall be selected, as a consequence of a click by the
- user. Subclasses should react to it by setting their selection state appropriately. The default
- implementation does nothing.
-
- \a event is the mouse event that caused the selection. \a additive indicates, whether the user
- was holding the multi-select-modifier while performing the selection (see \ref
- QCustomPlot::setMultiSelectModifier). if \a additive is true, the selection state must be toggled
- (i.e. become selected when unselected and unselected when selected).
-
- Every selectEvent is preceded by a call to \ref selectTest, which has returned positively (i.e.
- returned a value greater than 0 and less than the selection tolerance of the parent QCustomPlot).
- The \a details data you output from \ref selectTest is feeded back via \a details here. You may
- use it to transport any kind of information from the selectTest to the possibly subsequent
- selectEvent. Usually \a details is used to transfer which part was clicked, if it is a layerable
- that has multiple individually selectable parts (like QCPAxis). This way selectEvent doesn't need
- to do the calculation again to find out which part was actually clicked.
-
- \a selectionStateChanged is an output parameter. If the pointer is non-null, this function must
- set the value either to true or false, depending on whether the selection state of this layerable
- was actually changed. For layerables that only are selectable as a whole and not in parts, this
- is simple: if \a additive is true, \a selectionStateChanged must also be set to true, because the
- selection toggles. If \a additive is false, \a selectionStateChanged is only set to true, if the
- layerable was previously unselected and now is switched to the selected state.
-
- \see selectTest, deselectEvent
- */
- void QCPLayerable::selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
- {
- Q_UNUSED(event)
- Q_UNUSED(additive)
- Q_UNUSED(details)
- Q_UNUSED(selectionStateChanged)
- }
-
- /*! \internal
-
- This event is called when the layerable shall be deselected, either as consequence of a user
- interaction or a call to \ref QCustomPlot::deselectAll. Subclasses should react to it by
- unsetting their selection appropriately.
-
- just as in \ref selectEvent, the output parameter \a selectionStateChanged (if non-null), must
- return true or false when the selection state of this layerable has changed or not changed,
- respectively.
-
- \see selectTest, selectEvent
- */
- void QCPLayerable::deselectEvent(bool *selectionStateChanged)
- {
- Q_UNUSED(selectionStateChanged)
- }
-
-
- ////////////////////////////////////////////////////////////////////////////////////////////////////
- //////////////////// QCPRange
- ////////////////////////////////////////////////////////////////////////////////////////////////////
- /*! \class QCPRange
- \brief Represents the range an axis is encompassing.
-
- contains a \a lower and \a upper double value and provides convenience input, output and
- modification functions.
-
- \see QCPAxis::setRange
- */
-
- /*!
- Minimum range size (\a upper - \a lower) the range changing functions will accept. Smaller
- intervals would cause errors due to the 11-bit exponent of double precision numbers,
- corresponding to a minimum magnitude of roughly 1e-308.
- \see validRange, maxRange
- */
- const double QCPRange::minRange = 1e-280;
-
- /*!
- Maximum values (negative and positive) the range will accept in range-changing functions.
- Larger absolute values would cause errors due to the 11-bit exponent of double precision numbers,
- corresponding to a maximum magnitude of roughly 1e308.
- Since the number of planck-volumes in the entire visible universe is only ~1e183, this should
- be enough.
- \see validRange, minRange
- */
- const double QCPRange::maxRange = 1e250;
-
- /*!
- Constructs a range with \a lower and \a upper set to zero.
- */
- QCPRange::QCPRange() :
- lower(0),
- upper(0)
- {
- }
-
- /*! \overload
- Constructs a range with the specified \a lower and \a upper values.
- */
- QCPRange::QCPRange(double lower, double upper) :
- lower(lower),
- upper(upper)
- {
- normalize();
- }
-
- /*!
- Returns the size of the range, i.e. \a upper-\a lower
- */
- double QCPRange::size() const
- {
- return upper-lower;
- }
-
- /*!
- Returns the center of the range, i.e. (\a upper+\a lower)*0.5
- */
- double QCPRange::center() const
- {
- return (upper+lower)*0.5;
- }
-
- /*!
- Makes sure \a lower is numerically smaller than \a upper. If this is not the case, the values
- are swapped.
- */
- void QCPRange::normalize()
- {
- if (lower > upper)
- qSwap(lower, upper);
- }
-
- /*!
- Expands this range such that \a otherRange is contained in the new range. It is assumed that both
- this range and \a otherRange are normalized (see \ref normalize).
-
- If \a otherRange is already inside the current range, this function does nothing.
-
- \see expanded
- */
- void QCPRange::expand(const QCPRange &otherRange)
- {
- if (lower > otherRange.lower)
- lower = otherRange.lower;
- if (upper < otherRange.upper)
- upper = otherRange.upper;
- }
-
-
- /*!
- Returns an expanded range that contains this and \a otherRange. It is assumed that both this
- range and \a otherRange are normalized (see \ref normalize).
-
- \see expand
- */
- QCPRange QCPRange::expanded(const QCPRange &otherRange) const
- {
- QCPRange result = *this;
- result.expand(otherRange);
- return result;
- }
-
- /*!
- Returns a sanitized version of the range. Sanitized means for logarithmic scales, that
- the range won't span the positive and negative sign domain, i.e. contain zero. Further
- \a lower will always be numerically smaller (or equal) to \a upper.
-
- If the original range does span positive and negative sign domains or contains zero,
- the returned range will try to approximate the original range as good as possible.
- If the positive interval of the original range is wider than the negative interval, the
- returned range will only contain the positive interval, with lower bound set to \a rangeFac or
- \a rangeFac *\a upper, whichever is closer to zero. Same procedure is used if the negative interval
- is wider than the positive interval, this time by changing the \a upper bound.
- */
- QCPRange QCPRange::sanitizedForLogScale() const
- {
- double rangeFac = 1e-3;
- QCPRange sanitizedRange(lower, upper);
- sanitizedRange.normalize();
- // can't have range spanning negative and positive values in log plot, so change range to fix it
- //if (qFuzzyCompare(sanitizedRange.lower+1, 1) && !qFuzzyCompare(sanitizedRange.upper+1, 1))
- if (sanitizedRange.lower == 0.0 && sanitizedRange.upper != 0.0)
- {
- // case lower is 0
- if (rangeFac < sanitizedRange.upper*rangeFac)
- sanitizedRange.lower = rangeFac;
- else
- sanitizedRange.lower = sanitizedRange.upper*rangeFac;
- } //else if (!qFuzzyCompare(lower+1, 1) && qFuzzyCompare(upper+1, 1))
- else if (sanitizedRange.lower != 0.0 && sanitizedRange.upper == 0.0)
- {
- // case upper is 0
- if (-rangeFac > sanitizedRange.lower*rangeFac)
- sanitizedRange.upper = -rangeFac;
- else
- sanitizedRange.upper = sanitizedRange.lower*rangeFac;
- } else if (sanitizedRange.lower < 0 && sanitizedRange.upper > 0)
- {
- // find out whether negative or positive interval is wider to decide which sign domain will be chosen
- if (-sanitizedRange.lower > sanitizedRange.upper)
- {
- // negative is wider, do same as in case upper is 0
- if (-rangeFac > sanitizedRange.lower*rangeFac)
- sanitizedRange.upper = -rangeFac;
- else
- sanitizedRange.upper = sanitizedRange.lower*rangeFac;
- } else
- {
- // positive is wider, do same as in case lower is 0
- if (rangeFac < sanitizedRange.upper*rangeFac)
- sanitizedRange.lower = rangeFac;
- else
- sanitizedRange.lower = sanitizedRange.upper*rangeFac;
- }
- }
- // due to normalization, case lower>0 && upper<0 should never occur, because that implies upper<lower
- return sanitizedRange;
- }
-
- /*!
- Returns a sanitized version of the range. Sanitized means for linear scales, that
- \a lower will always be numerically smaller (or equal) to \a upper.
- */
- QCPRange QCPRange::sanitizedForLinScale() const
- {
- QCPRange sanitizedRange(lower, upper);
- sanitizedRange.normalize();
- return sanitizedRange;
- }
-
- /*!
- Returns true when \a value lies within or exactly on the borders of the range.
- */
- bool QCPRange::contains(double value) const
- {
- return value >= lower && value <= upper;
- }
-
- /*!
- Checks, whether the specified range is within valid bounds, which are defined
- as QCPRange::maxRange and QCPRange::minRange.
- A valid range means:
- \li range bounds within -maxRange and maxRange
- \li range size above minRange
- \li range size below maxRange
- */
- bool QCPRange::validRange(double lower, double upper)
- {
- /*
- return (lower > -maxRange &&
- upper < maxRange &&
- qAbs(lower-upper) > minRange &&
- (lower < -minRange || lower > minRange) &&
- (upper < -minRange || upper > minRange));
- */
- return (lower > -maxRange &&
- upper < maxRange &&
- qAbs(lower-upper) > minRange &&
- qAbs(lower-upper) < maxRange);
- }
-
- /*!
- \overload
- Checks, whether the specified range is within valid bounds, which are defined
- as QCPRange::maxRange and QCPRange::minRange.
- A valid range means:
- \li range bounds within -maxRange and maxRange
- \li range size above minRange
- \li range size below maxRange
- */
- bool QCPRange::validRange(const QCPRange &range)
- {
- /*
- return (range.lower > -maxRange &&
- range.upper < maxRange &&
- qAbs(range.lower-range.upper) > minRange &&
- qAbs(range.lower-range.upper) < maxRange &&
- (range.lower < -minRange || range.lower > minRange) &&
- (range.upper < -minRange || range.upper > minRange));
- */
- return (range.lower > -maxRange &&
- range.upper < maxRange &&
- qAbs(range.lower-range.upper) > minRange &&
- qAbs(range.lower-range.upper) < maxRange);
- }
-
-
- /*! \page thelayoutsystem The Layout System
-
- The layout system is responsible for positioning and scaling layout elements such as axis rects,
- legends and plot titles in a QCustomPlot.
-
- \section layoutsystem-classesandmechanisms Classes and mechanisms
-
- The layout system is based on the abstract base class \ref QCPLayoutElement. All objects that
- take part in the layout system derive from this class, either directly or indirectly.
-
- Since QCPLayoutElement itself derives from \ref QCPLayerable, a layout element may draw its own
- content. However, it is perfectly possible for a layout element to only serve as a structuring
- and/or positioning element, not drawing anything on its own.
-
- \subsection layoutsystem-rects Rects of a layout element
-
- A layout element is a rectangular object described by two rects: the inner rect (\ref
- QCPLayoutElement::rect) and the outer rect (\ref QCPLayoutElement::setOuterRect). The inner rect
- is calculated automatically by applying the margin (\ref QCPLayoutElement::setMargins) inward
- from the outer rect. The inner rect is meant for main content while the margin area may either be
- left blank or serve for displaying peripheral graphics. For example, \ref QCPAxisRect positions
- the four main axes at the sides of the inner rect, so graphs end up inside it and the axis labels
- and tick labels are in the margin area.
-
- \subsection layoutsystem-margins Margins
-
- Each layout element may provide a mechanism to automatically determine its margins. Internally,
- this is realized with the \ref QCPLayoutElement::calculateAutoMargin function which takes a \ref
- QCP::MarginSide and returns an integer value which represents the ideal margin for the specified
- side. The automatic margin will be used on the sides specified in \ref
- QCPLayoutElement::setAutoMargins. By default, it is set to \ref QCP::msAll meaning automatic
- margin calculation is enabled for all four sides. In this case, a minimum margin may be set with
- \ref QCPLayoutElement::setMinimumMargins, to prevent the automatic margin mechanism from setting
- margins smaller than desired for a specific situation. If automatic margin calculation is unset
- for a specific side, the margin of that side can be controlled directy via \ref
- QCPLayoutElement::setMargins.
-
- If multiple layout ements are arranged next to or beneath each other, it may be desirable to
- align their inner rects on certain sides. Since they all might have different automatic margins,
- this usually isn't the case. The class \ref QCPMarginGroup and \ref
- QCPLayoutElement::setMarginGroup fix this by allowing to synchronize multiple margins. See the
- documentation there for details.
-
- \subsection layoutsystem-layout Layouts
-
- As mentioned, a QCPLayoutElement may have an arbitrary number of child layout elements and in
- princple can have the only purpose to manage/arrange those child elements. This is what the
- subclass \ref QCPLayout specializes on. It is a QCPLayoutElement itself but has no visual
- representation. It defines an interface to add, remove and manage child layout elements.
- QCPLayout isn't a usable layout though, it's an abstract base class that concrete layouts derive
- from, like \ref QCPLayoutGrid which arranges its child elements in a grid and \ref QCPLayoutInset
- which allows placing child elements freely inside its rect.
-
- Since a QCPLayout is a layout element itself, it may be placed inside other layouts. This way,
- complex hierarchies may be created, offering very flexible arrangements.
-
- <div style="text-align:center">
- <div style="display:inline-block; margin-left:auto; margin-right:auto">\image html LayoutsystemSketch0.png ""</div>
- <div style="display:inline-block; margin-left:auto; margin-right:auto">\image html LayoutsystemSketch1.png ""</div>
- <div style="clear:both"></div>
- <div style="display:inline-block; max-width:1000px; text-align:justify">
- Sketch of the default QCPLayoutGrid accessible via \ref QCustomPlot::plotLayout. The left image
- shows the outer and inner rect of the grid layout itself while the right image shows how two
- child layout elements are placed inside the grid layout next to each other in cells (0, 0) and
- (0, 1).
- </div>
- </div>
-
- \subsection layoutsystem-plotlayout The top level plot layout
-
- Every QCustomPlot has one top level layout of type \ref QCPLayoutGrid. It is accessible via \ref
- QCustomPlot::plotLayout and contains (directly or indirectly via other sub-layouts) all layout
- elements in the QCustomPlot. By default, this top level grid layout contains a single cell which
- holds the main axis rect.
-
- \subsection layoutsystem-examples Examples
-
- <b>Adding a plot title</b> is a typical and simple case to demonstrate basic workings of the layout system.
- \code
- // first we create and prepare a plot title layout element:
- QCPPlotTitle *title = new QCPPlotTitle(customPlot);
- title->setText("Plot Title Example");
- title->setFont(QFont("sans", 12, QFont::Bold));
- // then we add it to the main plot layout:
- customPlot->plotLayout()->insertRow(0); // insert an empty row above the axis rect
- customPlot->plotLayout()->addElement(0, 0, title); // insert the title in the empty cell we just created
- \endcode
- \image html layoutsystem-addingplottitle.png
-
- <b>Arranging multiple axis rects</b> actually is the central purpose of the layout system.
- \code
- customPlot->plotLayout()->clear(); // let's start from scratch and remove the default axis rect
- // add the first axis rect in second row (row index 1):
- customPlot->plotLayout()->addElement(1, 0, new QCPAxisRect(customPlot));
- // create a sub layout that we'll place in first row:
- QCPLayoutGrid *subLayout = new QCPLayoutGrid;
- customPlot->plotLayout()->addElement(0, 0, subLayout);
- // add two axis rects in the sub layout next to eachother:
- subLayout->addElement(0, 0, new QCPAxisRect(customPlot));
- subLayout->addElement(0, 1, new QCPAxisRect(customPlot));
- subLayout->setColumnStretchFactor(0, 3); // left axis rect shall have 60% of width
- subLayout->setColumnStretchFactor(1, 2); // right one only 40% (3:2 = 60:40)
- \endcode
- \image html layoutsystem-multipleaxisrects.png
-
- */
-
-
- ////////////////////////////////////////////////////////////////////////////////////////////////////
- //////////////////// QCPMarginGroup
- ////////////////////////////////////////////////////////////////////////////////////////////////////
-
- /*! \class QCPMarginGroup
- \brief A margin group allows synchronization of margin sides if working with multiple layout elements.
-
- QCPMarginGroup allows you to tie a margin side of two or more layout elements together, such that
- they will all have the same size, based on the largest required margin in the group.
-
- \n
- \image html QCPMarginGroup.png "Demonstration of QCPMarginGroup"
- \n
-
- In certain situations it is desirable that margins at specific sides are synchronized across
- layout elements. For example, if one QCPAxisRect is below another one in a grid layout, it will
- provide a cleaner look to the user if the left and right margins of the two axis rects are of the
- same size. The left axis of the top axis rect will then be at the same horizontal position as the
- left axis of the lower axis rect, making them appear aligned. The same applies for the right
- axes. This is what QCPMarginGroup makes possible.
-
- To add/remove a specific side of a layout element to/from a margin group, use the \ref
- QCPLayoutElement::setMarginGroup method. To completely break apart the margin group, either call
- \ref clear, or just delete the margin group.
-
- \section QCPMarginGroup-example Example
-
- First create a margin group:
- \code
- QCPMarginGroup *group = new QCPMarginGroup(customPlot);
- \endcode
- Then set this group on the layout element sides:
- \code
- customPlot->axisRect(0)->setMarginGroup(QCP::msLeft|QCP::msRight, group);
- customPlot->axisRect(1)->setMarginGroup(QCP::msLeft|QCP::msRight, group);
- \endcode
- Here, we've used the first two axis rects of the plot and synchronized their left margins with
- each other and their right margins with each other.
- */
-
- /* start documentation of inline functions */
-
- /*! \fn QList<QCPLayoutElement*> QCPMarginGroup::elements(QCP::MarginSide side) const
-
- Returns a list of all layout elements that have their margin \a side associated with this margin
- group.
- */
-
- /* end documentation of inline functions */
-
- /*!
- Creates a new QCPMarginGroup instance in \a parentPlot.
- */
- QCPMarginGroup::QCPMarginGroup(QCustomPlot *parentPlot) :
- QObject(parentPlot),
- mParentPlot(parentPlot)
- {
- mChildren.insert(QCP::msLeft, QList<QCPLayoutElement*>());
- mChildren.insert(QCP::msRight, QList<QCPLayoutElement*>());
- mChildren.insert(QCP::msTop, QList<QCPLayoutElement*>());
- mChildren.insert(QCP::msBottom, QList<QCPLayoutElement*>());
- }
-
- QCPMarginGroup::~QCPMarginGroup()
- {
- clear();
- }
-
- /*!
- Returns whether this margin group is empty. If this function returns true, no layout elements use
- this margin group to synchronize margin sides.
- */
- bool QCPMarginGroup::isEmpty() const
- {
- QHashIterator<QCP::MarginSide, QList<QCPLayoutElement*> > it(mChildren);
- while (it.hasNext())
- {
- it.next();
- if (!it.value().isEmpty())
- return false;
- }
- return true;
- }
-
- /*!
- Clears this margin group. The synchronization of the margin sides that use this margin group is
- lifted and they will use their individual margin sizes again.
- */
- void QCPMarginGroup::clear()
- {
- // make all children remove themselves from this margin group:
- QHashIterator<QCP::MarginSide, QList<QCPLayoutElement*> > it(mChildren);
- while (it.hasNext())
- {
- it.next();
- const QList<QCPLayoutElement*> elements = it.value();
- for (int i=elements.size()-1; i>=0; --i)
- elements.at(i)->setMarginGroup(it.key(), 0); // removes itself from mChildren via removeChild
- }
- }
-
- /*! \internal
-
- Returns the synchronized common margin for \a side. This is the margin value that will be used by
- the layout element on the respective side, if it is part of this margin group.
-
- The common margin is calculated by requesting the automatic margin (\ref
- QCPLayoutElement::calculateAutoMargin) of each element associated with \a side in this margin
- group, and choosing the largest returned value. (QCPLayoutElement::minimumMargins is taken into
- account, too.)
- */
- int QCPMarginGroup::commonMargin(QCP::MarginSide side) const
- {
- // query all automatic margins of the layout elements in this margin group side and find maximum:
- int result = 0;
- const QList<QCPLayoutElement*> elements = mChildren.value(side);
- for (int i=0; i<elements.size(); ++i)
- {
- if (!elements.at(i)->autoMargins().testFlag(side))
- continue;
- int m = qMax(elements.at(i)->calculateAutoMargin(side), QCP::getMarginValue(elements.at(i)->minimumMargins(), side));
- if (m > result)
- result = m;
- }
- return result;
- }
-
- /*! \internal
-
- Adds \a element to the internal list of child elements, for the margin \a side.
-
- This function does not modify the margin group property of \a element.
- */
- void QCPMarginGroup::addChild(QCP::MarginSide side, QCPLayoutElement *element)
- {
- if (!mChildren[side].contains(element))
- mChildren[side].append(element);
- else
- qDebug() << Q_FUNC_INFO << "element is already child of this margin group side" << reinterpret_cast<quintptr>(element);
- }
-
- /*! \internal
-
- Removes \a element from the internal list of child elements, for the margin \a side.
-
- This function does not modify the margin group property of \a element.
- */
- void QCPMarginGroup::removeChild(QCP::MarginSide side, QCPLayoutElement *element)
- {
- if (!mChildren[side].removeOne(element))
- qDebug() << Q_FUNC_INFO << "element is not child of this margin group side" << reinterpret_cast<quintptr>(element);
- }
-
-
- ////////////////////////////////////////////////////////////////////////////////////////////////////
- //////////////////// QCPLayoutElement
- ////////////////////////////////////////////////////////////////////////////////////////////////////
-
- /*! \class QCPLayoutElement
- \brief The abstract base class for all objects that form \ref thelayoutsystem "the layout system".
-
- This is an abstract base class. As such, it can't be instantiated directly, rather use one of its subclasses.
-
- A Layout element is a rectangular object which can be placed in layouts. It has an outer rect
- (QCPLayoutElement::outerRect) and an inner rect (\ref QCPLayoutElement::rect). The difference
- between outer and inner rect is called its margin. The margin can either be set to automatic or
- manual (\ref setAutoMargins) on a per-side basis. If a side is set to manual, that margin can be
- set explicitly with \ref setMargins and will stay fixed at that value. If it's set to automatic,
- the layout element subclass will control the value itself (via \ref calculateAutoMargin).
-
- Layout elements can be placed in layouts (base class QCPLayout) like QCPLayoutGrid. The top level
- layout is reachable via \ref QCustomPlot::plotLayout, and is a \ref QCPLayoutGrid. Since \ref
- QCPLayout itself derives from \ref QCPLayoutElement, layouts can be nested.
-
- Thus in QCustomPlot one can divide layout elements into two categories: The ones that are
- invisible by themselves, because they don't draw anything. Their only purpose is to manage the
- position and size of other layout elements. This category of layout elements usually use
- QCPLayout as base class. Then there is the category of layout elements which actually draw
- something. For example, QCPAxisRect, QCPLegend and QCPPlotTitle are of this category. This does
- not necessarily mean that the latter category can't have child layout elements. QCPLegend for
- instance, actually derives from QCPLayoutGrid and the individual legend items are child layout
- elements in the grid layout.
- */
-
- /* start documentation of inline functions */
-
- /*! \fn QCPLayout *QCPLayoutElement::layout() const
-
- Returns the parent layout of this layout element.
- */
-
- /*! \fn QRect QCPLayoutElement::rect() const
-
- Returns the inner rect of this layout element. The inner rect is the outer rect (\ref
- setOuterRect) shrinked by the margins (\ref setMargins, \ref setAutoMargins).
-
- In some cases, the area between outer and inner rect is left blank. In other cases the margin
- area is used to display peripheral graphics while the main content is in the inner rect. This is
- where automatic margin calculation becomes interesting because it allows the layout element to
- adapt the margins to the peripheral graphics it wants to draw. For example, \ref QCPAxisRect
- draws the axis labels and tick labels in the margin area, thus needs to adjust the margins (if
- \ref setAutoMargins is enabled) according to the space required by the labels of the axes.
- */
-
- /*! \fn virtual void QCPLayoutElement::mousePressEvent(QMouseEvent *event)
-
- This event is called, if the mouse was pressed while being inside the outer rect of this layout
- element.
- */
-
- /*! \fn virtual void QCPLayoutElement::mouseMoveEvent(QMouseEvent *event)
-
- This event is called, if the mouse is moved inside the outer rect of this layout element.
- */
-
- /*! \fn virtual void QCPLayoutElement::mouseReleaseEvent(QMouseEvent *event)
-
- This event is called, if the mouse was previously pressed inside the outer rect of this layout
- element and is now released.
- */
-
- /*! \fn virtual void QCPLayoutElement::mouseDoubleClickEvent(QMouseEvent *event)
-
- This event is called, if the mouse is double-clicked inside the outer rect of this layout
- element.
- */
-
- /*! \fn virtual void QCPLayoutElement::wheelEvent(QWheelEvent *event)
-
- This event is called, if the mouse wheel is scrolled while the cursor is inside the rect of this
- layout element.
- */
-
- /* end documentation of inline functions */
-
- /*!
- Creates an instance of QCPLayoutElement and sets default values.
- */
- QCPLayoutElement::QCPLayoutElement(QCustomPlot *parentPlot) :
- QCPLayerable(parentPlot), // parenthood is changed as soon as layout element gets inserted into a layout (except for top level layout)
- mParentLayout(0),
- mMinimumSize(),
- mMaximumSize(QWIDGETSIZE_MAX, QWIDGETSIZE_MAX),
- mRect(0, 0, 0, 0),
- mOuterRect(0, 0, 0, 0),
- mMargins(0, 0, 0, 0),
- mMinimumMargins(0, 0, 0, 0),
- mAutoMargins(QCP::msAll)
- {
- }
-
- QCPLayoutElement::~QCPLayoutElement()
- {
- setMarginGroup(QCP::msAll, 0); // unregister at margin groups, if there are any
- // unregister at layout:
- if (qobject_cast<QCPLayout*>(mParentLayout)) // the qobject_cast is just a safeguard in case the layout forgets to call clear() in its dtor and this dtor is called by QObject dtor
- mParentLayout->take(this);
- }
-
- /*!
- Sets the outer rect of this layout element. If the layout element is inside a layout, the layout
- sets the position and size of this layout element using this function.
-
- Calling this function externally has no effect, since the layout will overwrite any changes to
- the outer rect upon the next replot.
-
- The layout element will adapt its inner \ref rect by applying the margins inward to the outer rect.
-
- \see rect
- */
- void QCPLayoutElement::setOuterRect(const QRect &rect)
- {
- if (mOuterRect != rect)
- {
- mOuterRect = rect;
- mRect = mOuterRect.adjusted(mMargins.left(), mMargins.top(), -mMargins.right(), -mMargins.bottom());
- }
- }
-
- /*!
- Sets the margins of this layout element. If \ref setAutoMargins is disabled for some or all
- sides, this function is used to manually set the margin on those sides. Sides that are still set
- to be handled automatically are ignored and may have any value in \a margins.
-
- The margin is the distance between the outer rect (controlled by the parent layout via \ref
- setOuterRect) and the inner \ref rect (which usually contains the main content of this layout
- element).
-
- \see setAutoMargins
- */
- void QCPLayoutElement::setMargins(const QMargins &margins)
- {
- if (mMargins != margins)
- {
- mMargins = margins;
- mRect = mOuterRect.adjusted(mMargins.left(), mMargins.top(), -mMargins.right(), -mMargins.bottom());
- }
- }
-
- /*!
- If \ref setAutoMargins is enabled on some or all margins, this function is used to provide
- minimum values for those margins.
-
- The minimum values are not enforced on margin sides that were set to be under manual control via
- \ref setAutoMargins.
-
- \see setAutoMargins
- */
- void QCPLayoutElement::setMinimumMargins(const QMargins &margins)
- {
- if (mMinimumMargins != margins)
- {
- mMinimumMargins = margins;
- }
- }
-
- /*!
- Sets on which sides the margin shall be calculated automatically. If a side is calculated
- automatically, a minimum margin value may be provided with \ref setMinimumMargins. If a side is
- set to be controlled manually, the value may be specified with \ref setMargins.
-
- Margin sides that are under automatic control may participate in a \ref QCPMarginGroup (see \ref
- setMarginGroup), to synchronize (align) it with other layout elements in the plot.
-
- \see setMinimumMargins, setMargins
- */
- void QCPLayoutElement::setAutoMargins(QCP::MarginSides sides)
- {
- mAutoMargins = sides;
- }
-
- /*!
- Sets the minimum size for the inner \ref rect of this layout element. A parent layout tries to
- respect the \a size here by changing row/column sizes in the layout accordingly.
-
- If the parent layout size is not sufficient to satisfy all minimum size constraints of its child
- layout elements, the layout may set a size that is actually smaller than \a size. QCustomPlot
- propagates the layout's size constraints to the outside by setting its own minimum QWidget size
- accordingly, so violations of \a size should be exceptions.
- */
- void QCPLayoutElement::setMinimumSize(const QSize &size)
- {
- if (mMinimumSize != size)
- {
- mMinimumSize = size;
- if (mParentLayout)
- mParentLayout->sizeConstraintsChanged();
- }
- }
-
- /*! \overload
-
- Sets the minimum size for the inner \ref rect of this layout element.
- */
- void QCPLayoutElement::setMinimumSize(int width, int height)
- {
- setMinimumSize(QSize(width, height));
- }
-
- /*!
- Sets the maximum size for the inner \ref rect of this layout element. A parent layout tries to
- respect the \a size here by changing row/column sizes in the layout accordingly.
- */
- void QCPLayoutElement::setMaximumSize(const QSize &size)
- {
- if (mMaximumSize != size)
- {
- mMaximumSize = size;
- if (mParentLayout)
- mParentLayout->sizeConstraintsChanged();
- }
- }
-
- /*! \overload
-
- Sets the maximum size for the inner \ref rect of this layout element.
- */
- void QCPLayoutElement::setMaximumSize(int width, int height)
- {
- setMaximumSize(QSize(width, height));
- }
-
- /*!
- Sets the margin \a group of the specified margin \a sides.
-
- Margin groups allow synchronizing specified margins across layout elements, see the documentation
- of \ref QCPMarginGroup.
-
- To unset the margin group of \a sides, set \a group to 0.
-
- Note that margin groups only work for margin sides that are set to automatic (\ref
- setAutoMargins).
- */
- void QCPLayoutElement::setMarginGroup(QCP::MarginSides sides, QCPMarginGroup *group)
- {
- QVector<QCP::MarginSide> sideVector;
- if (sides.testFlag(QCP::msLeft)) sideVector.append(QCP::msLeft);
- if (sides.testFlag(QCP::msRight)) sideVector.append(QCP::msRight);
- if (sides.testFlag(QCP::msTop)) sideVector.append(QCP::msTop);
- if (sides.testFlag(QCP::msBottom)) sideVector.append(QCP::msBottom);
-
- for (int i=0; i<sideVector.size(); ++i)
- {
- QCP::MarginSide side = sideVector.at(i);
- if (marginGroup(side) != group)
- {
- QCPMarginGroup *oldGroup = marginGroup(side);
- if (oldGroup) // unregister at old group
- oldGroup->removeChild(side, this);
-
- if (!group) // if setting to 0, remove hash entry. Else set hash entry to new group and register there
- {
- mMarginGroups.remove(side);
- } else // setting to a new group
- {
- mMarginGroups[side] = group;
- group->addChild(side, this);
- }
- }
- }
- }
-
- /*!
- Updates the layout element and sub-elements. This function is automatically called upon replot by
- the parent layout element.
-
- Layout elements that have child elements should call the \ref update method of their child
- elements.
-
- The default implementation executes the automatic margin mechanism, so subclasses should make
- sure to call the base class implementation.
- */
- void QCPLayoutElement::update()
- {
- if (mAutoMargins != QCP::msNone)
- {
- // set the margins of this layout element according to automatic margin calculation, either directly or via a margin group:
- QMargins newMargins = mMargins;
- QVector<QCP::MarginSide> marginSides = QVector<QCP::MarginSide>() << QCP::msLeft << QCP::msRight << QCP::msTop << QCP::msBottom;
- for (int i=0; i<marginSides.size(); ++i)
- {
- QCP::MarginSide side = marginSides.at(i);
- if (mAutoMargins.testFlag(side)) // this side's margin shall be calculated automatically
- {
- if (mMarginGroups.contains(side))
- QCP::setMarginValue(newMargins, side, mMarginGroups[side]->commonMargin(side)); // this side is part of a margin group, so get the margin value from that group
- else
- QCP::setMarginValue(newMargins, side, calculateAutoMargin(side)); // this side is not part of a group, so calculate the value directly
- // apply minimum margin restrictions:
- if (QCP::getMarginValue(newMargins, side) < QCP::getMarginValue(mMinimumMargins, side))
- QCP::setMarginValue(newMargins, side, QCP::getMarginValue(mMinimumMargins, side));
- }
- }
- setMargins(newMargins);
- }
- }
-
- /*!
- Returns the minimum size this layout element (the inner \ref rect) may be compressed to.
-
- if a minimum size (\ref setMinimumSize) was not set manually, parent layouts consult this
- function to determine the minimum allowed size of this layout element. (A manual minimum size is
- considered set if it is non-zero.)
- */
- QSize QCPLayoutElement::minimumSizeHint() const
- {
- return mMinimumSize;
- }
-
- /*!
- Returns the maximum size this layout element (the inner \ref rect) may be expanded to.
-
- if a maximum size (\ref setMaximumSize) was not set manually, parent layouts consult this
- function to determine the maximum allowed size of this layout element. (A manual maximum size is
- considered set if it is smaller than Qt's QWIDGETSIZE_MAX.)
- */
- QSize QCPLayoutElement::maximumSizeHint() const
- {
- return mMaximumSize;
- }
-
- /*!
- Returns a list of all child elements in this layout element. If \a recursive is true, all
- sub-child elements are included in the list, too.
-
- Note that there may be entries with value 0 in the returned list. (For example, QCPLayoutGrid may have
- empty cells which yield 0 at the respective index.)
- */
- QList<QCPLayoutElement*> QCPLayoutElement::elements(bool recursive) const
- {
- Q_UNUSED(recursive)
- return QList<QCPLayoutElement*>();
- }
-
- /*!
- Layout elements are sensitive to events inside their outer rect. If \a pos is within the outer
- rect, this method returns a value corresponding to 0.99 times the parent plot's selection
- tolerance. However, layout elements are not selectable by default. So if \a onlySelectable is
- true, -1.0 is returned.
-
- See \ref QCPLayerable::selectTest for a general explanation of this virtual method.
-
- QCPLayoutElement subclasses may reimplement this method to provide more specific selection test
- behaviour.
- */
- double QCPLayoutElement::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const
- {
- Q_UNUSED(details)
-
- if (onlySelectable)
- return -1;
-
- if (QRectF(mOuterRect).contains(pos))
- {
- if (mParentPlot)
- return mParentPlot->selectionTolerance()*0.99;
- else
- {
- qDebug() << Q_FUNC_INFO << "parent plot not defined";
- return -1;
- }
- } else
- return -1;
- }
-
- /*! \internal
-
- propagates the parent plot initialization to all child elements, by calling \ref
- QCPLayerable::initializeParentPlot on them.
- */
- void QCPLayoutElement::parentPlotInitialized(QCustomPlot *parentPlot)
- {
- QList<QCPLayoutElement*> els = elements(false);
- for (int i=0; i<els.size(); ++i)
- {
- if (!els.at(i)->parentPlot())
- els.at(i)->initializeParentPlot(parentPlot);
- }
- }
-
- /*! \internal
-
- Returns the margin size for this \a side. It is used if automatic margins is enabled for this \a
- side (see \ref setAutoMargins). If a minimum margin was set with \ref setMinimumMargins, the
- returned value will not be smaller than the specified minimum margin.
-
- The default implementation just returns the respective manual margin (\ref setMargins) or the
- minimum margin, whichever is larger.
- */
- int QCPLayoutElement::calculateAutoMargin(QCP::MarginSide side)
- {
- return qMax(QCP::getMarginValue(mMargins, side), QCP::getMarginValue(mMinimumMargins, side));
- }
-
- ////////////////////////////////////////////////////////////////////////////////////////////////////
- //////////////////// QCPLayout
- ////////////////////////////////////////////////////////////////////////////////////////////////////
-
- /*! \class QCPLayout
- \brief The abstract base class for layouts
-
- This is an abstract base class for layout elements whose main purpose is to define the position
- and size of other child layout elements. In most cases, layouts don't draw anything themselves
- (but there are exceptions to this, e.g. QCPLegend).
-
- QCPLayout derives from QCPLayoutElement, and thus can itself be nested in other layouts.
-
- QCPLayout introduces a common interface for accessing and manipulating the child elements. Those
- functions are most notably \ref elementCount, \ref elementAt, \ref takeAt, \ref take, \ref
- simplify, \ref removeAt, \ref remove and \ref clear. Individual subclasses may add more functions
- to this interface which are more specialized to the form of the layout. For example, \ref
- QCPLayoutGrid adds functions that take row and column indices to access cells of the layout grid
- more conveniently.
-
- Since this is an abstract base class, you can't instantiate it directly. Rather use one of its
- subclasses like QCPLayoutGrid or QCPLayoutInset.
-
- For a general introduction to the layout system, see the dedicated documentation page \ref
- thelayoutsystem "The Layout System".
- */
-
- /* start documentation of pure virtual functions */
-
- /*! \fn virtual int QCPLayout::elementCount() const = 0
-
- Returns the number of elements/cells in the layout.
-
- \see elements, elementAt
- */
-
- /*! \fn virtual QCPLayoutElement* QCPLayout::elementAt(int index) const = 0
-
- Returns the element in the cell with the given \a index. If \a index is invalid, returns 0.
-
- Note that even if \a index is valid, the respective cell may be empty in some layouts (e.g.
- QCPLayoutGrid), so this function may return 0 in those cases. You may use this function to check
- whether a cell is empty or not.
-
- \see elements, elementCount, takeAt
- */
-
- /*! \fn virtual QCPLayoutElement* QCPLayout::takeAt(int index) = 0
-
- Removes the element with the given \a index from the layout and returns it.
-
- If the \a index is invalid or the cell with that index is empty, returns 0.
-
- Note that some layouts don't remove the respective cell right away but leave an empty cell after
- successful removal of the layout element. To collapse empty cells, use \ref simplify.
-
- \see elementAt, take
- */
-
- /*! \fn virtual bool QCPLayout::take(QCPLayoutElement* element) = 0
-
- Removes the specified \a element from the layout and returns true on success.
-
- If the \a element isn't in this layout, returns false.
-
- Note that some layouts don't remove the respective cell right away but leave an empty cell after
- successful removal of the layout element. To collapse empty cells, use \ref simplify.
-
- \see takeAt
- */
-
- /* end documentation of pure virtual functions */
-
- /*!
- Creates an instance of QCPLayoutElement and sets default values. Note that since QCPLayoutElement
- is an abstract base class, it can't be instantiated directly.
- */
- QCPLayout::QCPLayout()
- {
- }
-
- /*!
- First calls the QCPLayoutElement::update base class implementation to update the margins on this
- layout.
-
- Then calls \ref updateLayout which subclasses reimplement to reposition and resize their cells.
-
- Finally, \ref update is called on all child elements.
- */
- void QCPLayout::update()
- {
- QCPLayoutElement::update(); // recalculates (auto-)margins
-
- // set child element rects according to layout:
- updateLayout();
-
- // propagate update call to child elements:
- for (int i=0; i<elementCount(); ++i)
- {
- if (QCPLayoutElement *el = elementAt(i))
- el->update();
- }
- }
-
- /* inherits documentation from base class */
- QList<QCPLayoutElement*> QCPLayout::elements(bool recursive) const
- {
- int c = elementCount();
- QList<QCPLayoutElement*> result;
- #if QT_VERSION >= QT_VERSION_CHECK(4, 7, 0)
- result.reserve(c);
- #endif
- for (int i=0; i<c; ++i)
- result.append(elementAt(i));
- if (recursive)
- {
- for (int i=0; i<c; ++i)
- {
- if (result.at(i))
- result << result.at(i)->elements(recursive);
- }
- }
- return result;
- }
-
- /*!
- Simplifies the layout by collapsing empty cells. The exact behavior depends on subclasses, the
- default implementation does nothing.
-
- Not all layouts need simplification. For example, QCPLayoutInset doesn't use explicit
- simplification while QCPLayoutGrid does.
- */
- void QCPLayout::simplify()
- {
- }
-
- /*!
- Removes and deletes the element at the provided \a index. Returns true on success. If \a index is
- invalid or points to an empty cell, returns false.
-
- This function internally uses \ref takeAt to remove the element from the layout and then deletes
- the returned element.
-
- \see remove, takeAt
- */
- bool QCPLayout::removeAt(int index)
- {
- if (QCPLayoutElement *el = takeAt(index))
- {
- delete el;
- return true;
- } else
- return false;
- }
-
- /*!
- Removes and deletes the provided \a element. Returns true on success. If \a element is not in the
- layout, returns false.
-
- This function internally uses \ref takeAt to remove the element from the layout and then deletes
- the element.
-
- \see removeAt, take
- */
- bool QCPLayout::remove(QCPLayoutElement *element)
- {
- if (take(element))
- {
- delete element;
- return true;
- } else
- return false;
- }
-
- /*!
- Removes and deletes all layout elements in this layout.
-
- \see remove, removeAt
- */
- void QCPLayout::clear()
- {
- for (int i=elementCount()-1; i>=0; --i)
- {
- if (elementAt(i))
- removeAt(i);
- }
- simplify();
- }
-
- /*!
- Subclasses call this method to report changed (minimum/maximum) size constraints.
-
- If the parent of this layout is again a QCPLayout, forwards the call to the parent's \ref
- sizeConstraintsChanged. If the parent is a QWidget (i.e. is the \ref QCustomPlot::plotLayout of
- QCustomPlot), calls QWidget::updateGeometry, so if the QCustomPlot widget is inside a Qt QLayout,
- it may update itself and resize cells accordingly.
- */
- void QCPLayout::sizeConstraintsChanged() const
- {
- if (QWidget *w = qobject_cast<QWidget*>(parent()))
- w->updateGeometry();
- else if (QCPLayout *l = qobject_cast<QCPLayout*>(parent()))
- l->sizeConstraintsChanged();
- }
-
- /*! \internal
-
- Subclasses reimplement this method to update the position and sizes of the child elements/cells
- via calling their \ref QCPLayoutElement::setOuterRect. The default implementation does nothing.
-
- The geometry used as a reference is the inner \ref rect of this layout. Child elements should stay
- within that rect.
-
- \ref getSectionSizes may help with the reimplementation of this function.
-
- \see update
- */
- void QCPLayout::updateLayout()
- {
- }
-
-
- /*! \internal
-
- Associates \a el with this layout. This is done by setting the \ref QCPLayoutElement::layout, the
- \ref QCPLayerable::parentLayerable and the QObject parent to this layout.
-
- Further, if \a el didn't previously have a parent plot, calls \ref
- QCPLayerable::initializeParentPlot on \a el to set the paret plot.
-
- This method is used by subclass specific methods that add elements to the layout. Note that this
- method only changes properties in \a el. The removal from the old layout and the insertion into
- the new layout must be done additionally.
- */
- void QCPLayout::adoptElement(QCPLayoutElement *el)
- {
- if (el)
- {
- el->mParentLayout = this;
- el->setParentLayerable(this);
- el->setParent(this);
- if (!el->parentPlot())
- el->initializeParentPlot(mParentPlot);
- } else
- qDebug() << Q_FUNC_INFO << "Null element passed";
- }
-
- /*! \internal
-
- Disassociates \a el from this layout. This is done by setting the \ref QCPLayoutElement::layout
- and the \ref QCPLayerable::parentLayerable to zero. The QObject parent is set to the parent
- QCustomPlot.
-
- This method is used by subclass specific methods that remove elements from the layout (e.g. \ref
- take or \ref takeAt). Note that this method only changes properties in \a el. The removal from
- the old layout must be done additionally.
- */
- void QCPLayout::releaseElement(QCPLayoutElement *el)
- {
- if (el)
- {
- el->mParentLayout = 0;
- el->setParentLayerable(0);
- el->setParent(mParentPlot);
- // Note: Don't initializeParentPlot(0) here, because layout element will stay in same parent plot
- } else
- qDebug() << Q_FUNC_INFO << "Null element passed";
- }
-
- /*! \internal
-
- This is a helper function for the implementation of \ref updateLayout in subclasses.
-
- It calculates the sizes of one-dimensional sections with provided constraints on maximum section
- sizes, minimum section sizes, relative stretch factors and the final total size of all sections.
-
- The QVector entries refer to the sections. Thus all QVectors must have the same size.
-
- \a maxSizes gives the maximum allowed size of each section. If there shall be no maximum size
- imposed, set all vector values to Qt's QWIDGETSIZE_MAX.
-
- \a minSizes gives the minimum allowed size of each section. If there shall be no minimum size
- imposed, set all vector values to zero. If the \a minSizes entries add up to a value greater than
- \a totalSize, sections will be scaled smaller than the proposed minimum sizes. (In other words,
- not exceeding the allowed total size is taken to be more important than not going below minimum
- section sizes.)
-
- \a stretchFactors give the relative proportions of the sections to each other. If all sections
- shall be scaled equally, set all values equal. If the first section shall be double the size of
- each individual other section, set the first number of \a stretchFactors to double the value of
- the other individual values (e.g. {2, 1, 1, 1}).
-
- \a totalSize is the value that the final section sizes will add up to. Due to rounding, the
- actual sum may differ slightly. If you want the section sizes to sum up to exactly that value,
- you could distribute the remaining difference on the sections.
-
- The return value is a QVector containing the section sizes.
- */
- QVector<int> QCPLayout::getSectionSizes(QVector<int> maxSizes, QVector<int> minSizes, QVector<double> stretchFactors, int totalSize) const
- {
- if (maxSizes.size() != minSizes.size() || minSizes.size() != stretchFactors.size())
- {
- qDebug() << Q_FUNC_INFO << "Passed vector sizes aren't equal:" << maxSizes << minSizes << stretchFactors;
- return QVector<int>();
- }
- if (stretchFactors.isEmpty())
- return QVector<int>();
- int sectionCount = stretchFactors.size();
- QVector<double> sectionSizes(sectionCount);
- // if provided total size is forced smaller than total minimum size, ignore minimum sizes (squeeze sections):
- int minSizeSum = 0;
- for (int i=0; i<sectionCount; ++i)
- minSizeSum += minSizes.at(i);
- if (totalSize < minSizeSum)
- {
- // new stretch factors are minimum sizes and minimum sizes are set to zero:
- for (int i=0; i<sectionCount; ++i)
- {
- stretchFactors[i] = minSizes.at(i);
- minSizes[i] = 0;
- }
- }
-
- QList<int> minimumLockedSections;
- QList<int> unfinishedSections;
- for (int i=0; i<sectionCount; ++i)
- unfinishedSections.append(i);
- double freeSize = totalSize;
-
- int outerIterations = 0;
- while (!unfinishedSections.isEmpty() && outerIterations < sectionCount*2) // the iteration check ist just a failsafe in case something really strange happens
- {
- ++outerIterations;
- int innerIterations = 0;
- while (!unfinishedSections.isEmpty() && innerIterations < sectionCount*2) // the iteration check ist just a failsafe in case something really strange happens
- {
- ++innerIterations;
- // find section that hits its maximum next:
- int nextId = -1;
- double nextMax = 1e12;
- for (int i=0; i<unfinishedSections.size(); ++i)
- {
- int secId = unfinishedSections.at(i);
- double hitsMaxAt = (maxSizes.at(secId)-sectionSizes.at(secId))/stretchFactors.at(secId);
- if (hitsMaxAt < nextMax)
- {
- nextMax = hitsMaxAt;
- nextId = secId;
- }
- }
- // check if that maximum is actually within the bounds of the total size (i.e. can we stretch all remaining sections so far that the found section
- // actually hits its maximum, without exceeding the total size when we add up all sections)
- double stretchFactorSum = 0;
- for (int i=0; i<unfinishedSections.size(); ++i)
- stretchFactorSum += stretchFactors.at(unfinishedSections.at(i));
- double nextMaxLimit = freeSize/stretchFactorSum;
- if (nextMax < nextMaxLimit) // next maximum is actually hit, move forward to that point and fix the size of that section
- {
- for (int i=0; i<unfinishedSections.size(); ++i)
- {
- sectionSizes[unfinishedSections.at(i)] += nextMax*stretchFactors.at(unfinishedSections.at(i)); // increment all sections
- freeSize -= nextMax*stretchFactors.at(unfinishedSections.at(i));
- }
- unfinishedSections.removeOne(nextId); // exclude the section that is now at maximum from further changes
- } else // next maximum isn't hit, just distribute rest of free space on remaining sections
- {
- for (int i=0; i<unfinishedSections.size(); ++i)
- sectionSizes[unfinishedSections.at(i)] += nextMaxLimit*stretchFactors.at(unfinishedSections.at(i)); // increment all sections
- unfinishedSections.clear();
- }
- }
- if (innerIterations == sectionCount*2)
- qDebug() << Q_FUNC_INFO << "Exceeded maximum expected inner iteration count, layouting aborted. Input was:" << maxSizes << minSizes << stretchFactors << totalSize;
-
- // now check whether the resulting section sizes violate minimum restrictions:
- bool foundMinimumViolation = false;
- for (int i=0; i<sectionSizes.size(); ++i)
- {
- if (minimumLockedSections.contains(i))
- continue;
- if (sectionSizes.at(i) < minSizes.at(i)) // section violates minimum
- {
- sectionSizes[i] = minSizes.at(i); // set it to minimum
- foundMinimumViolation = true; // make sure we repeat the whole optimization process
- minimumLockedSections.append(i);
- }
- }
- if (foundMinimumViolation)
- {
- freeSize = totalSize;
- for (int i=0; i<sectionCount; ++i)
- {
- if (!minimumLockedSections.contains(i)) // only put sections that haven't hit their minimum back into the pool
- unfinishedSections.append(i);
- else
- freeSize -= sectionSizes.at(i); // remove size of minimum locked sections from available space in next round
- }
- // reset all section sizes to zero that are in unfinished sections (all others have been set to their minimum):
- for (int i=0; i<unfinishedSections.size(); ++i)
- sectionSizes[unfinishedSections.at(i)] = 0;
- }
- }
- if (outerIterations == sectionCount*2)
- qDebug() << Q_FUNC_INFO << "Exceeded maximum expected outer iteration count, layouting aborted. Input was:" << maxSizes << minSizes << stretchFactors << totalSize;
-
- QVector<int> result(sectionCount);
- for (int i=0; i<sectionCount; ++i)
- result[i] = qRound(sectionSizes.at(i));
- return result;
- }
-
-
- ////////////////////////////////////////////////////////////////////////////////////////////////////
- //////////////////// QCPLayoutGrid
- ////////////////////////////////////////////////////////////////////////////////////////////////////
-
- /*! \class QCPLayoutGrid
- \brief A layout that arranges child elements in a grid
-
- Elements are laid out in a grid with configurable stretch factors (\ref setColumnStretchFactor,
- \ref setRowStretchFactor) and spacing (\ref setColumnSpacing, \ref setRowSpacing).
-
- Elements can be added to cells via \ref addElement. The grid is expanded if the specified row or
- column doesn't exist yet. Whether a cell contains a valid layout element can be checked with \ref
- hasElement, that element can be retrieved with \ref element. If rows and columns that only have
- empty cells shall be removed, call \ref simplify. Removal of elements is either done by just
- adding the element to a different layout or by using the QCPLayout interface \ref take or \ref
- remove.
-
- Row and column insertion can be performed with \ref insertRow and \ref insertColumn.
- */
-
- /*!
- Creates an instance of QCPLayoutGrid and sets default values.
- */
- QCPLayoutGrid::QCPLayoutGrid() :
- mColumnSpacing(5),
- mRowSpacing(5)
- {
- }
-
- QCPLayoutGrid::~QCPLayoutGrid()
- {
- // clear all child layout elements. This is important because only the specific layouts know how
- // to handle removing elements (clear calls virtual removeAt method to do that).
- clear();
- }
-
- /*!
- Returns the element in the cell in \a row and \a column.
-
- Returns 0 if either the row/column is invalid or if the cell is empty. In those cases, a qDebug
- message is printed. To check whether a cell exists and isn't empty, use \ref hasElement.
-
- \see addElement, hasElement
- */
- QCPLayoutElement *QCPLayoutGrid::element(int row, int column) const
- {
- if (row >= 0 && row < mElements.size())
- {
- if (column >= 0 && column < mElements.first().size())
- {
- if (QCPLayoutElement *result = mElements.at(row).at(column))
- return result;
- else
- qDebug() << Q_FUNC_INFO << "Requested cell is empty. Row:" << row << "Column:" << column;
- } else
- qDebug() << Q_FUNC_INFO << "Invalid column. Row:" << row << "Column:" << column;
- } else
- qDebug() << Q_FUNC_INFO << "Invalid row. Row:" << row << "Column:" << column;
- return 0;
- }
-
- /*!
- Returns the number of rows in the layout.
-
- \see columnCount
- */
- int QCPLayoutGrid::rowCount() const
- {
- return mElements.size();
- }
-
- /*!
- Returns the number of columns in the layout.
-
- \see rowCount
- */
- int QCPLayoutGrid::columnCount() const
- {
- if (mElements.size() > 0)
- return mElements.first().size();
- else
- return 0;
- }
-
- /*!
- Adds the \a element to cell with \a row and \a column. If \a element is already in a layout, it
- is first removed from there. If \a row or \a column don't exist yet, the layout is expanded
- accordingly.
-
- Returns true if the element was added successfully, i.e. if the cell at \a row and \a column
- didn't already have an element.
-
- \see element, hasElement, take, remove
- */
- bool QCPLayoutGrid::addElement(int row, int column, QCPLayoutElement *element)
- {
- if (element)
- {
- if (!hasElement(row, column))
- {
- if (element->layout()) // remove from old layout first
- element->layout()->take(element);
- expandTo(row+1, column+1);
- mElements[row][column] = element;
- adoptElement(element);
- return true;
- } else
- qDebug() << Q_FUNC_INFO << "There is already an element in the specified row/column:" << row << column;
- } else
- qDebug() << Q_FUNC_INFO << "Can't add null element to row/column:" << row << column;
- return false;
- }
-
- /*!
- Returns whether the cell at \a row and \a column exists and contains a valid element, i.e. isn't
- empty.
-
- \see element
- */
- bool QCPLayoutGrid::hasElement(int row, int column)
- {
- if (row >= 0 && row < rowCount() && column >= 0 && column < columnCount())
- return mElements.at(row).at(column);
- else
- return false;
- }
-
- /*!
- Sets the stretch \a factor of \a column.
-
- Stretch factors control the relative sizes of rows and columns. Cells will not be resized beyond
- their minimum and maximum widths/heights (\ref QCPLayoutElement::setMinimumSize, \ref
- QCPLayoutElement::setMaximumSize), regardless of the stretch factor.
-
- The default stretch factor of newly created rows/columns is 1.
-
- \see setColumnStretchFactors, setRowStretchFactor
- */
- void QCPLayoutGrid::setColumnStretchFactor(int column, double factor)
- {
- if (column >= 0 && column < columnCount())
- {
- if (factor > 0)
- mColumnStretchFactors[column] = factor;
- else
- qDebug() << Q_FUNC_INFO << "Invalid stretch factor, must be positive:" << factor;
- } else
- qDebug() << Q_FUNC_INFO << "Invalid column:" << column;
- }
-
- /*!
- Sets the stretch \a factors of all columns. \a factors must have the size \ref columnCount.
-
- Stretch factors control the relative sizes of rows and columns. Cells will not be resized beyond
- their minimum and maximum widths/heights (\ref QCPLayoutElement::setMinimumSize, \ref
- QCPLayoutElement::setMaximumSize), regardless of the stretch factor.
-
- The default stretch factor of newly created rows/columns is 1.
-
- \see setColumnStretchFactor, setRowStretchFactors
- */
- void QCPLayoutGrid::setColumnStretchFactors(const QList<double> &factors)
- {
- if (factors.size() == mColumnStretchFactors.size())
- {
- mColumnStretchFactors = factors;
- for (int i=0; i<mColumnStretchFactors.size(); ++i)
- {
- if (mColumnStretchFactors.at(i) <= 0)
- {
- qDebug() << Q_FUNC_INFO << "Invalid stretch factor, must be positive:" << mColumnStretchFactors.at(i);
- mColumnStretchFactors[i] = 1;
- }
- }
- } else
- qDebug() << Q_FUNC_INFO << "Column count not equal to passed stretch factor count:" << factors;
- }
-
- /*!
- Sets the stretch \a factor of \a row.
-
- Stretch factors control the relative sizes of rows and columns. Cells will not be resized beyond
- their minimum and maximum widths/heights (\ref QCPLayoutElement::setMinimumSize, \ref
- QCPLayoutElement::setMaximumSize), regardless of the stretch factor.
-
- The default stretch factor of newly created rows/columns is 1.
-
- \see setColumnStretchFactors, setRowStretchFactor
- */
- void QCPLayoutGrid::setRowStretchFactor(int row, double factor)
- {
- if (row >= 0 && row < rowCount())
- {
- if (factor > 0)
- mRowStretchFactors[row] = factor;
- else
- qDebug() << Q_FUNC_INFO << "Invalid stretch factor, must be positive:" << factor;
- } else
- qDebug() << Q_FUNC_INFO << "Invalid row:" << row;
- }
-
- /*!
- Sets the stretch \a factors of all rows. \a factors must have the size \ref rowCount.
-
- Stretch factors control the relative sizes of rows and columns. Cells will not be resized beyond
- their minimum and maximum widths/heights (\ref QCPLayoutElement::setMinimumSize, \ref
- QCPLayoutElement::setMaximumSize), regardless of the stretch factor.
-
- The default stretch factor of newly created rows/columns is 1.
-
- \see setRowStretchFactor, setColumnStretchFactors
- */
- void QCPLayoutGrid::setRowStretchFactors(const QList<double> &factors)
- {
- if (factors.size() == mRowStretchFactors.size())
- {
- mRowStretchFactors = factors;
- for (int i=0; i<mRowStretchFactors.size(); ++i)
- {
- if (mRowStretchFactors.at(i) <= 0)
- {
- qDebug() << Q_FUNC_INFO << "Invalid stretch factor, must be positive:" << mRowStretchFactors.at(i);
- mRowStretchFactors[i] = 1;
- }
- }
- } else
- qDebug() << Q_FUNC_INFO << "Row count not equal to passed stretch factor count:" << factors;
- }
-
- /*!
- Sets the gap that is left blank between columns to \a pixels.
-
- \see setRowSpacing
- */
- void QCPLayoutGrid::setColumnSpacing(int pixels)
- {
- mColumnSpacing = pixels;
- }
-
- /*!
- Sets the gap that is left blank between rows to \a pixels.
-
- \see setColumnSpacing
- */
- void QCPLayoutGrid::setRowSpacing(int pixels)
- {
- mRowSpacing = pixels;
- }
-
- /*!
- Expands the layout to have \a newRowCount rows and \a newColumnCount columns. So the last valid
- row index will be \a newRowCount-1, the last valid column index will be \a newColumnCount-1.
-
- If the current column/row count is already larger or equal to \a newColumnCount/\a newRowCount,
- this function does nothing in that dimension.
-
- Newly created cells are empty, new rows and columns have the stretch factor 1.
-
- Note that upon a call to \ref addElement, the layout is expanded automatically to contain the
- specified row and column, using this function.
-
- \see simplify
- */
- void QCPLayoutGrid::expandTo(int newRowCount, int newColumnCount)
- {
- // add rows as necessary:
- while (rowCount() < newRowCount)
- {
- mElements.append(QList<QCPLayoutElement*>());
- mRowStretchFactors.append(1);
- }
- // go through rows and expand columns as necessary:
- int newColCount = qMax(columnCount(), newColumnCount);
- for (int i=0; i<rowCount(); ++i)
- {
- while (mElements.at(i).size() < newColCount)
- mElements[i].append(0);
- }
- while (mColumnStretchFactors.size() < newColCount)
- mColumnStretchFactors.append(1);
- }
-
- /*!
- Inserts a new row with empty cells at the row index \a newIndex. Valid values for \a newIndex
- range from 0 (inserts a row at the top) to \a rowCount (appends a row at the bottom).
-
- \see insertColumn
- */
- void QCPLayoutGrid::insertRow(int newIndex)
- {
- if (mElements.isEmpty() || mElements.first().isEmpty()) // if grid is completely empty, add first cell
- {
- expandTo(1, 1);
- return;
- }
-
- if (newIndex < 0)
- newIndex = 0;
- if (newIndex > rowCount())
- newIndex = rowCount();
-
- mRowStretchFactors.insert(newIndex, 1);
- QList<QCPLayoutElement*> newRow;
- for (int col=0; col<columnCount(); ++col)
- newRow.append((QCPLayoutElement*)0);
- mElements.insert(newIndex, newRow);
- }
-
- /*!
- Inserts a new column with empty cells at the column index \a newIndex. Valid values for \a
- newIndex range from 0 (inserts a row at the left) to \a rowCount (appends a row at the right).
-
- \see insertRow
- */
- void QCPLayoutGrid::insertColumn(int newIndex)
- {
- if (mElements.isEmpty() || mElements.first().isEmpty()) // if grid is completely empty, add first cell
- {
- expandTo(1, 1);
- return;
- }
-
- if (newIndex < 0)
- newIndex = 0;
- if (newIndex > columnCount())
- newIndex = columnCount();
-
- mColumnStretchFactors.insert(newIndex, 1);
- for (int row=0; row<rowCount(); ++row)
- mElements[row].insert(newIndex, (QCPLayoutElement*)0);
- }
-
- /* inherits documentation from base class */
- void QCPLayoutGrid::updateLayout()
- {
- QVector<int> minColWidths, minRowHeights, maxColWidths, maxRowHeights;
- getMinimumRowColSizes(&minColWidths, &minRowHeights);
- getMaximumRowColSizes(&maxColWidths, &maxRowHeights);
-
- int totalRowSpacing = (rowCount()-1) * mRowSpacing;
- int totalColSpacing = (columnCount()-1) * mColumnSpacing;
- QVector<int> colWidths = getSectionSizes(maxColWidths, minColWidths, mColumnStretchFactors.toVector(), mRect.width()-totalColSpacing);
- QVector<int> rowHeights = getSectionSizes(maxRowHeights, minRowHeights, mRowStretchFactors.toVector(), mRect.height()-totalRowSpacing);
-
- // go through cells and set rects accordingly:
- int yOffset = mRect.top();
- for (int row=0; row<rowCount(); ++row)
- {
- if (row > 0)
- yOffset += rowHeights.at(row-1)+mRowSpacing;
- int xOffset = mRect.left();
- for (int col=0; col<columnCount(); ++col)
- {
- if (col > 0)
- xOffset += colWidths.at(col-1)+mColumnSpacing;
- if (mElements.at(row).at(col))
- mElements.at(row).at(col)->setOuterRect(QRect(xOffset, yOffset, colWidths.at(col), rowHeights.at(row)));
- }
- }
- }
-
- /* inherits documentation from base class */
- int QCPLayoutGrid::elementCount() const
- {
- return rowCount()*columnCount();
- }
-
- /* inherits documentation from base class */
- QCPLayoutElement *QCPLayoutGrid::elementAt(int index) const
- {
- if (index >= 0 && index < elementCount())
- return mElements.at(index / columnCount()).at(index % columnCount());
- else
- return 0;
- }
-
- /* inherits documentation from base class */
- QCPLayoutElement *QCPLayoutGrid::takeAt(int index)
- {
- if (QCPLayoutElement *el = elementAt(index))
- {
- releaseElement(el);
- mElements[index / columnCount()][index % columnCount()] = 0;
- return el;
- } else
- {
- qDebug() << Q_FUNC_INFO << "Attempt to take invalid index:" << index;
- return 0;
- }
- }
-
- /* inherits documentation from base class */
- bool QCPLayoutGrid::take(QCPLayoutElement *element)
- {
- if (element)
- {
- for (int i=0; i<elementCount(); ++i)
- {
- if (elementAt(i) == element)
- {
- takeAt(i);
- return true;
- }
- }
- qDebug() << Q_FUNC_INFO << "Element not in this layout, couldn't take";
- } else
- qDebug() << Q_FUNC_INFO << "Can't take null element";
- return false;
- }
-
- /* inherits documentation from base class */
- QList<QCPLayoutElement*> QCPLayoutGrid::elements(bool recursive) const
- {
- QList<QCPLayoutElement*> result;
- int colC = columnCount();
- int rowC = rowCount();
- #if QT_VERSION >= QT_VERSION_CHECK(4, 7, 0)
- result.reserve(colC*rowC);
- #endif
- for (int row=0; row<rowC; ++row)
- {
- for (int col=0; col<colC; ++col)
- {
- result.append(mElements.at(row).at(col));
- }
- }
- if (recursive)
- {
- int c = result.size();
- for (int i=0; i<c; ++i)
- {
- if (result.at(i))
- result << result.at(i)->elements(recursive);
- }
- }
- return result;
- }
-
- /*!
- Simplifies the layout by collapsing rows and columns which only contain empty cells.
- */
- void QCPLayoutGrid::simplify()
- {
- // remove rows with only empty cells:
- for (int row=rowCount()-1; row>=0; --row)
- {
- bool hasElements = false;
- for (int col=0; col<columnCount(); ++col)
- {
- if (mElements.at(row).at(col))
- {
- hasElements = true;
- break;
- }
- }
- if (!hasElements)
- {
- mRowStretchFactors.removeAt(row);
- mElements.removeAt(row);
- if (mElements.isEmpty()) // removed last element, also remove stretch factor (wouldn't happen below because also columnCount changed to 0 now)
- mColumnStretchFactors.clear();
- }
- }
-
- // remove columns with only empty cells:
- for (int col=columnCount()-1; col>=0; --col)
- {
- bool hasElements = false;
- for (int row=0; row<rowCount(); ++row)
- {
- if (mElements.at(row).at(col))
- {
- hasElements = true;
- break;
- }
- }
- if (!hasElements)
- {
- mColumnStretchFactors.removeAt(col);
- for (int row=0; row<rowCount(); ++row)
- mElements[row].removeAt(col);
- }
- }
- }
-
- /* inherits documentation from base class */
- QSize QCPLayoutGrid::minimumSizeHint() const
- {
- QVector<int> minColWidths, minRowHeights;
- getMinimumRowColSizes(&minColWidths, &minRowHeights);
- QSize result(0, 0);
- for (int i=0; i<minColWidths.size(); ++i)
- result.rwidth() += minColWidths.at(i);
- for (int i=0; i<minRowHeights.size(); ++i)
- result.rheight() += minRowHeights.at(i);
- result.rwidth() += qMax(0, columnCount()-1) * mColumnSpacing + mMargins.left() + mMargins.right();
- result.rheight() += qMax(0, rowCount()-1) * mRowSpacing + mMargins.top() + mMargins.bottom();
- return result;
- }
-
- /* inherits documentation from base class */
- QSize QCPLayoutGrid::maximumSizeHint() const
- {
- QVector<int> maxColWidths, maxRowHeights;
- getMaximumRowColSizes(&maxColWidths, &maxRowHeights);
-
- QSize result(0, 0);
- for (int i=0; i<maxColWidths.size(); ++i)
- result.setWidth(qMin(result.width()+maxColWidths.at(i), QWIDGETSIZE_MAX));
- for (int i=0; i<maxRowHeights.size(); ++i)
- result.setHeight(qMin(result.height()+maxRowHeights.at(i), QWIDGETSIZE_MAX));
- result.rwidth() += qMax(0, columnCount()-1) * mColumnSpacing + mMargins.left() + mMargins.right();
- result.rheight() += qMax(0, rowCount()-1) * mRowSpacing + mMargins.top() + mMargins.bottom();
- return result;
- }
-
- /*! \internal
-
- Places the minimum column widths and row heights into \a minColWidths and \a minRowHeights
- respectively.
-
- The minimum height of a row is the largest minimum height of any element in that row. The minimum
- width of a column is the largest minimum width of any element in that column.
-
- This is a helper function for \ref updateLayout.
-
- \see getMaximumRowColSizes
- */
- void QCPLayoutGrid::getMinimumRowColSizes(QVector<int> *minColWidths, QVector<int> *minRowHeights) const
- {
- *minColWidths = QVector<int>(columnCount(), 0);
- *minRowHeights = QVector<int>(rowCount(), 0);
- for (int row=0; row<rowCount(); ++row)
- {
- for (int col=0; col<columnCount(); ++col)
- {
- if (mElements.at(row).at(col))
- {
- QSize minHint = mElements.at(row).at(col)->minimumSizeHint();
- QSize min = mElements.at(row).at(col)->minimumSize();
- QSize final(min.width() > 0 ? min.width() : minHint.width(), min.height() > 0 ? min.height() : minHint.height());
- if (minColWidths->at(col) < final.width())
- (*minColWidths)[col] = final.width();
- if (minRowHeights->at(row) < final.height())
- (*minRowHeights)[row] = final.height();
- }
- }
- }
- }
-
- /*! \internal
-
- Places the maximum column widths and row heights into \a maxColWidths and \a maxRowHeights
- respectively.
-
- The maximum height of a row is the smallest maximum height of any element in that row. The
- maximum width of a column is the smallest maximum width of any element in that column.
-
- This is a helper function for \ref updateLayout.
-
- \see getMinimumRowColSizes
- */
- void QCPLayoutGrid::getMaximumRowColSizes(QVector<int> *maxColWidths, QVector<int> *maxRowHeights) const
- {
- *maxColWidths = QVector<int>(columnCount(), QWIDGETSIZE_MAX);
- *maxRowHeights = QVector<int>(rowCount(), QWIDGETSIZE_MAX);
- for (int row=0; row<rowCount(); ++row)
- {
- for (int col=0; col<columnCount(); ++col)
- {
- if (mElements.at(row).at(col))
- {
- QSize maxHint = mElements.at(row).at(col)->maximumSizeHint();
- QSize max = mElements.at(row).at(col)->maximumSize();
- QSize final(max.width() < QWIDGETSIZE_MAX ? max.width() : maxHint.width(), max.height() < QWIDGETSIZE_MAX ? max.height() : maxHint.height());
- if (maxColWidths->at(col) > final.width())
- (*maxColWidths)[col] = final.width();
- if (maxRowHeights->at(row) > final.height())
- (*maxRowHeights)[row] = final.height();
- }
- }
- }
- }
-
-
- ////////////////////////////////////////////////////////////////////////////////////////////////////
- //////////////////// QCPLayoutInset
- ////////////////////////////////////////////////////////////////////////////////////////////////////
- /*! \class QCPLayoutInset
- \brief A layout that places child elements aligned to the border or arbitrarily positioned
-
- Elements are placed either aligned to the border or at arbitrary position in the area of the
- layout. Which placement applies is controlled with the \ref InsetPlacement (\ref
- setInsetPlacement).
-
- Elements are added via \ref addElement(QCPLayoutElement *element, Qt::Alignment alignment) or
- addElement(QCPLayoutElement *element, const QRectF &rect). If the first method is used, the inset
- placement will default to \ref ipBorderAligned and the element will be aligned according to the
- \a alignment parameter. The second method defaults to \ref ipFree and allows placing elements at
- arbitrary position and size, defined by \a rect.
-
- The alignment or rect can be set via \ref setInsetAlignment or \ref setInsetRect, respectively.
-
- This is the layout that every QCPAxisRect has as \ref QCPAxisRect::insetLayout.
- */
-
- /* start documentation of inline functions */
-
- /*! \fn virtual void QCPLayoutInset::simplify()
-
- The QCPInsetLayout does not need simplification since it can never have empty cells due to its
- linear index structure. This method does nothing.
- */
-
- /* end documentation of inline functions */
-
- /*!
- Creates an instance of QCPLayoutInset and sets default values.
- */
- QCPLayoutInset::QCPLayoutInset()
- {
- }
-
- QCPLayoutInset::~QCPLayoutInset()
- {
- // clear all child layout elements. This is important because only the specific layouts know how
- // to handle removing elements (clear calls virtual removeAt method to do that).
- clear();
- }
-
- /*!
- Returns the placement type of the element with the specified \a index.
- */
- QCPLayoutInset::InsetPlacement QCPLayoutInset::insetPlacement(int index) const
- {
- if (elementAt(index))
- return mInsetPlacement.at(index);
- else
- {
- qDebug() << Q_FUNC_INFO << "Invalid element index:" << index;
- return ipFree;
- }
- }
-
- /*!
- Returns the alignment of the element with the specified \a index. The alignment only has a
- meaning, if the inset placement (\ref setInsetPlacement) is \ref ipBorderAligned.
- */
- Qt::Alignment QCPLayoutInset::insetAlignment(int index) const
- {
- if (elementAt(index))
- return mInsetAlignment.at(index);
- else
- {
- qDebug() << Q_FUNC_INFO << "Invalid element index:" << index;
- return 0;
- }
- }
-
- /*!
- Returns the rect of the element with the specified \a index. The rect only has a
- meaning, if the inset placement (\ref setInsetPlacement) is \ref ipFree.
- */
- QRectF QCPLayoutInset::insetRect(int index) const
- {
- if (elementAt(index))
- return mInsetRect.at(index);
- else
- {
- qDebug() << Q_FUNC_INFO << "Invalid element index:" << index;
- return QRectF();
- }
- }
-
- /*!
- Sets the inset placement type of the element with the specified \a index to \a placement.
-
- \see InsetPlacement
- */
- void QCPLayoutInset::setInsetPlacement(int index, QCPLayoutInset::InsetPlacement placement)
- {
- if (elementAt(index))
- mInsetPlacement[index] = placement;
- else
- qDebug() << Q_FUNC_INFO << "Invalid element index:" << index;
- }
-
- /*!
- If the inset placement (\ref setInsetPlacement) is \ref ipBorderAligned, this function
- is used to set the alignment of the element with the specified \a index to \a alignment.
-
- \a alignment is an or combination of the following alignment flags: Qt::AlignLeft,
- Qt::AlignHCenter, Qt::AlighRight, Qt::AlignTop, Qt::AlignVCenter, Qt::AlignBottom. Any other
- alignment flags will be ignored.
- */
- void QCPLayoutInset::setInsetAlignment(int index, Qt::Alignment alignment)
- {
- if (elementAt(index))
- mInsetAlignment[index] = alignment;
- else
- qDebug() << Q_FUNC_INFO << "Invalid element index:" << index;
- }
-
- /*!
- If the inset placement (\ref setInsetPlacement) is \ref ipFree, this function is used to set the
- position and size of the element with the specified \a index to \a rect.
-
- \a rect is given in fractions of the whole inset layout rect. So an inset with rect (0, 0, 1, 1)
- will span the entire layout. An inset with rect (0.6, 0.1, 0.35, 0.35) will be in the top right
- corner of the layout, with 35% width and height of the parent layout.
-
- Note that the minimum and maximum sizes of the embedded element (\ref
- QCPLayoutElement::setMinimumSize, \ref QCPLayoutElement::setMaximumSize) are enforced.
- */
- void QCPLayoutInset::setInsetRect(int index, const QRectF &rect)
- {
- if (elementAt(index))
- mInsetRect[index] = rect;
- else
- qDebug() << Q_FUNC_INFO << "Invalid element index:" << index;
- }
-
- /* inherits documentation from base class */
- void QCPLayoutInset::updateLayout()
- {
- for (int i=0; i<mElements.size(); ++i)
- {
- QRect insetRect;
- QSize finalMinSize, finalMaxSize;
- QSize minSizeHint = mElements.at(i)->minimumSizeHint();
- QSize maxSizeHint = mElements.at(i)->maximumSizeHint();
- finalMinSize.setWidth(mElements.at(i)->minimumSize().width() > 0 ? mElements.at(i)->minimumSize().width() : minSizeHint.width());
- finalMinSize.setHeight(mElements.at(i)->minimumSize().height() > 0 ? mElements.at(i)->minimumSize().height() : minSizeHint.height());
- finalMaxSize.setWidth(mElements.at(i)->maximumSize().width() < QWIDGETSIZE_MAX ? mElements.at(i)->maximumSize().width() : maxSizeHint.width());
- finalMaxSize.setHeight(mElements.at(i)->maximumSize().height() < QWIDGETSIZE_MAX ? mElements.at(i)->maximumSize().height() : maxSizeHint.height());
- if (mInsetPlacement.at(i) == ipFree)
- {
- insetRect = QRect(rect().x()+rect().width()*mInsetRect.at(i).x(),
- rect().y()+rect().height()*mInsetRect.at(i).y(),
- rect().width()*mInsetRect.at(i).width(),
- rect().height()*mInsetRect.at(i).height());
- if (insetRect.size().width() < finalMinSize.width())
- insetRect.setWidth(finalMinSize.width());
- if (insetRect.size().height() < finalMinSize.height())
- insetRect.setHeight(finalMinSize.height());
- if (insetRect.size().width() > finalMaxSize.width())
- insetRect.setWidth(finalMaxSize.width());
- if (insetRect.size().height() > finalMaxSize.height())
- insetRect.setHeight(finalMaxSize.height());
- } else if (mInsetPlacement.at(i) == ipBorderAligned)
- {
- insetRect.setSize(finalMinSize);
- Qt::Alignment al = mInsetAlignment.at(i);
- if (al.testFlag(Qt::AlignLeft)) insetRect.moveLeft(rect().x());
- else if (al.testFlag(Qt::AlignRight)) insetRect.moveRight(rect().x()+rect().width());
- else insetRect.moveLeft(rect().x()+rect().width()*0.5-finalMinSize.width()*0.5); // default to Qt::AlignHCenter
- if (al.testFlag(Qt::AlignTop)) insetRect.moveTop(rect().y());
- else if (al.testFlag(Qt::AlignBottom)) insetRect.moveBottom(rect().y()+rect().height());
- else insetRect.moveTop(rect().y()+rect().height()*0.5-finalMinSize.height()*0.5); // default to Qt::AlignVCenter
- }
- mElements.at(i)->setOuterRect(insetRect);
- }
- }
-
- /* inherits documentation from base class */
- int QCPLayoutInset::elementCount() const
- {
- return mElements.size();
- }
-
- /* inherits documentation from base class */
- QCPLayoutElement *QCPLayoutInset::elementAt(int index) const
- {
- if (index >= 0 && index < mElements.size())
- return mElements.at(index);
- else
- return 0;
- }
-
- /* inherits documentation from base class */
- QCPLayoutElement *QCPLayoutInset::takeAt(int index)
- {
- if (QCPLayoutElement *el = elementAt(index))
- {
- releaseElement(el);
- mElements.removeAt(index);
- mInsetPlacement.removeAt(index);
- mInsetAlignment.removeAt(index);
- mInsetRect.removeAt(index);
- return el;
- } else
- {
- qDebug() << Q_FUNC_INFO << "Attempt to take invalid index:" << index;
- return 0;
- }
- }
-
- /* inherits documentation from base class */
- bool QCPLayoutInset::take(QCPLayoutElement *element)
- {
- if (element)
- {
- for (int i=0; i<elementCount(); ++i)
- {
- if (elementAt(i) == element)
- {
- takeAt(i);
- return true;
- }
- }
- qDebug() << Q_FUNC_INFO << "Element not in this layout, couldn't take";
- } else
- qDebug() << Q_FUNC_INFO << "Can't take null element";
- return false;
- }
-
- /*!
- The inset layout is sensitive to events only at areas where its child elements are sensitive. If
- the selectTest method of any of the child elements returns a positive number for \a pos, this
- method returns a value corresponding to 0.99 times the parent plot's selection tolerance. The
- inset layout is not selectable itself by default. So if \a onlySelectable is true, -1.0 is
- returned.
-
- See \ref QCPLayerable::selectTest for a general explanation of this virtual method.
- */
- double QCPLayoutInset::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const
- {
- Q_UNUSED(details)
- if (onlySelectable)
- return -1;
-
- for (int i=0; i<mElements.size(); ++i)
- {
- // inset layout shall only return positive selectTest, if actually an inset object is at pos
- // else it would block the entire underlying QCPAxisRect with its surface.
- if (mElements.at(i)->selectTest(pos, onlySelectable) >= 0)
- return mParentPlot->selectionTolerance()*0.99;
- }
- return -1;
- }
-
- /*!
- Adds the specified \a element to the layout as an inset aligned at the border (\ref
- setInsetAlignment is initialized with \ref ipBorderAligned). The alignment is set to \a
- alignment.
-
- \a alignment is an or combination of the following alignment flags: Qt::AlignLeft,
- Qt::AlignHCenter, Qt::AlighRight, Qt::AlignTop, Qt::AlignVCenter, Qt::AlignBottom. Any other
- alignment flags will be ignored.
-
- \see addElement(QCPLayoutElement *element, const QRectF &rect)
- */
- void QCPLayoutInset::addElement(QCPLayoutElement *element, Qt::Alignment alignment)
- {
- if (element)
- {
- if (element->layout()) // remove from old layout first
- element->layout()->take(element);
- mElements.append(element);
- mInsetPlacement.append(ipBorderAligned);
- mInsetAlignment.append(alignment);
- mInsetRect.append(QRectF(0.6, 0.6, 0.4, 0.4));
- adoptElement(element);
- } else
- qDebug() << Q_FUNC_INFO << "Can't add null element";
- }
-
- /*!
- Adds the specified \a element to the layout as an inset with free positioning/sizing (\ref
- setInsetAlignment is initialized with \ref ipFree). The position and size is set to \a
- rect.
-
- \a rect is given in fractions of the whole inset layout rect. So an inset with rect (0, 0, 1, 1)
- will span the entire layout. An inset with rect (0.6, 0.1, 0.35, 0.35) will be in the top right
- corner of the layout, with 35% width and height of the parent layout.
-
- \see addElement(QCPLayoutElement *element, Qt::Alignment alignment)
- */
- void QCPLayoutInset::addElement(QCPLayoutElement *element, const QRectF &rect)
- {
- if (element)
- {
- if (element->layout()) // remove from old layout first
- element->layout()->take(element);
- mElements.append(element);
- mInsetPlacement.append(ipFree);
- mInsetAlignment.append(Qt::AlignRight|Qt::AlignTop);
- mInsetRect.append(rect);
- adoptElement(element);
- } else
- qDebug() << Q_FUNC_INFO << "Can't add null element";
- }
-
-
- ////////////////////////////////////////////////////////////////////////////////////////////////////
- //////////////////// QCPLineEnding
- ////////////////////////////////////////////////////////////////////////////////////////////////////
-
- /*! \class QCPLineEnding
- \brief Handles the different ending decorations for line-like items
-
- \image html QCPLineEnding.png "The various ending styles currently supported"
-
- For every ending a line-like item has, an instance of this class exists. For example, QCPItemLine
- has two endings which can be set with QCPItemLine::setHead and QCPItemLine::setTail.
-
- The styles themselves are defined via the enum QCPLineEnding::EndingStyle. Most decorations can
- be modified regarding width and length, see \ref setWidth and \ref setLength. The direction of
- the ending decoration (e.g. direction an arrow is pointing) is controlled by the line-like item.
- For example, when both endings of a QCPItemLine are set to be arrows, they will point to opposite
- directions, e.g. "outward". This can be changed by \ref setInverted, which would make the
- respective arrow point inward.
-
- Note that due to the overloaded QCPLineEnding constructor, you may directly specify a
- QCPLineEnding::EndingStyle where actually a QCPLineEnding is expected, e.g. \code
- myItemLine->setHead(QCPLineEnding::esSpikeArrow) \endcode
- */
-
- /*!
- Creates a QCPLineEnding instance with default values (style \ref esNone).
- */
- QCPLineEnding::QCPLineEnding() :
- mStyle(esNone),
- mWidth(8),
- mLength(10),
- mInverted(false)
- {
- }
-
- /*!
- Creates a QCPLineEnding instance with the specified values.
- */
- QCPLineEnding::QCPLineEnding(QCPLineEnding::EndingStyle style, double width, double length, bool inverted) :
- mStyle(style),
- mWidth(width),
- mLength(length),
- mInverted(inverted)
- {
- }
-
- /*!
- Sets the style of the ending decoration.
- */
- void QCPLineEnding::setStyle(QCPLineEnding::EndingStyle style)
- {
- mStyle = style;
- }
-
- /*!
- Sets the width of the ending decoration, if the style supports it. On arrows, for example, the
- width defines the size perpendicular to the arrow's pointing direction.
-
- \see setLength
- */
- void QCPLineEnding::setWidth(double width)
- {
- mWidth = width;
- }
-
- /*!
- Sets the length of the ending decoration, if the style supports it. On arrows, for example, the
- length defines the size in pointing direction.
-
- \see setWidth
- */
- void QCPLineEnding::setLength(double length)
- {
- mLength = length;
- }
-
- /*!
- Sets whether the ending decoration shall be inverted. For example, an arrow decoration will point
- inward when \a inverted is set to true.
-
- Note that also the \a width direction is inverted. For symmetrical ending styles like arrows or
- discs, this doesn't make a difference. However, asymmetric styles like \ref esHalfBar are
- affected by it, which can be used to control to which side the half bar points to.
- */
- void QCPLineEnding::setInverted(bool inverted)
- {
- mInverted = inverted;
- }
-
- /*! \internal
-
- Returns the maximum pixel radius the ending decoration might cover, starting from the position
- the decoration is drawn at (typically a line ending/\ref QCPItemPosition of an item).
-
- This is relevant for clipping. Only omit painting of the decoration when the position where the
- decoration is supposed to be drawn is farther away from the clipping rect than the returned
- distance.
- */
- double QCPLineEnding::boundingDistance() const
- {
- switch (mStyle)
- {
- case esNone:
- return 0;
-
- case esFlatArrow:
- case esSpikeArrow:
- case esLineArrow:
- case esSkewedBar:
- return qSqrt(mWidth*mWidth+mLength*mLength); // items that have width and length
-
- case esDisc:
- case esSquare:
- case esDiamond:
- case esBar:
- case esHalfBar:
- return mWidth*1.42; // items that only have a width -> width*sqrt(2)
-
- }
- return 0;
- }
-
- /*!
- Starting from the origin of this line ending (which is style specific), returns the length
- covered by the line ending symbol, in backward direction.
-
- For example, the \ref esSpikeArrow has a shorter real length than a \ref esFlatArrow, even if
- both have the same \ref setLength value, because the spike arrow has an inward curved back, which
- reduces the length along its center axis (the drawing origin for arrows is at the tip).
-
- This function is used for precise, style specific placement of line endings, for example in
- QCPAxes.
- */
- double QCPLineEnding::realLength() const
- {
- switch (mStyle)
- {
- case esNone:
- case esLineArrow:
- case esSkewedBar:
- case esBar:
- case esHalfBar:
- return 0;
-
- case esFlatArrow:
- return mLength;
-
- case esDisc:
- case esSquare:
- case esDiamond:
- return mWidth*0.5;
-
- case esSpikeArrow:
- return mLength*0.8;
- }
- return 0;
- }
-
- /*! \internal
-
- Draws the line ending with the specified \a painter at the position \a pos. The direction of the
- line ending is controlled with \a dir.
- */
- void QCPLineEnding::draw(QCPPainter *painter, const QVector2D &pos, const QVector2D &dir) const
- {
- if (mStyle == esNone)
- return;
-
- QVector2D lengthVec(dir.normalized());
- if (lengthVec.isNull())
- lengthVec = QVector2D(1, 0);
- QVector2D widthVec(-lengthVec.y(), lengthVec.x());
- lengthVec *= mLength*(mInverted ? -1 : 1);
- widthVec *= mWidth*0.5*(mInverted ? -1 : 1);
-
- QPen penBackup = painter->pen();
- QBrush brushBackup = painter->brush();
- QPen miterPen = penBackup;
- miterPen.setJoinStyle(Qt::MiterJoin); // to make arrow heads spikey
- QBrush brush(painter->pen().color(), Qt::SolidPattern);
- switch (mStyle)
- {
- case esNone: break;
- case esFlatArrow:
- {
- QPointF points[3] = {pos.toPointF(),
- (pos-lengthVec+widthVec).toPointF(),
- (pos-lengthVec-widthVec).toPointF()
- };
- painter->setPen(miterPen);
- painter->setBrush(brush);
- painter->drawConvexPolygon(points, 3);
- painter->setBrush(brushBackup);
- painter->setPen(penBackup);
- break;
- }
- case esSpikeArrow:
- {
- QPointF points[4] = {pos.toPointF(),
- (pos-lengthVec+widthVec).toPointF(),
- (pos-lengthVec*0.8).toPointF(),
- (pos-lengthVec-widthVec).toPointF()
- };
- painter->setPen(miterPen);
- painter->setBrush(brush);
- painter->drawConvexPolygon(points, 4);
- painter->setBrush(brushBackup);
- painter->setPen(penBackup);
- break;
- }
- case esLineArrow:
- {
- QPointF points[3] = {(pos-lengthVec+widthVec).toPointF(),
- pos.toPointF(),
- (pos-lengthVec-widthVec).toPointF()
- };
- painter->setPen(miterPen);
- painter->drawPolyline(points, 3);
- painter->setPen(penBackup);
- break;
- }
- case esDisc:
- {
- painter->setBrush(brush);
- painter->drawEllipse(pos.toPointF(), mWidth*0.5, mWidth*0.5);
- painter->setBrush(brushBackup);
- break;
- }
- case esSquare:
- {
- QVector2D widthVecPerp(-widthVec.y(), widthVec.x());
- QPointF points[4] = {(pos-widthVecPerp+widthVec).toPointF(),
- (pos-widthVecPerp-widthVec).toPointF(),
- (pos+widthVecPerp-widthVec).toPointF(),
- (pos+widthVecPerp+widthVec).toPointF()
- };
- painter->setPen(miterPen);
- painter->setBrush(brush);
- painter->drawConvexPolygon(points, 4);
- painter->setBrush(brushBackup);
- painter->setPen(penBackup);
- break;
- }
- case esDiamond:
- {
- QVector2D widthVecPerp(-widthVec.y(), widthVec.x());
- QPointF points[4] = {(pos-widthVecPerp).toPointF(),
- (pos-widthVec).toPointF(),
- (pos+widthVecPerp).toPointF(),
- (pos+widthVec).toPointF()
- };
- painter->setPen(miterPen);
- painter->setBrush(brush);
- painter->drawConvexPolygon(points, 4);
- painter->setBrush(brushBackup);
- painter->setPen(penBackup);
- break;
- }
- case esBar:
- {
- painter->drawLine((pos+widthVec).toPointF(), (pos-widthVec).toPointF());
- break;
- }
- case esHalfBar:
- {
- painter->drawLine((pos+widthVec).toPointF(), pos.toPointF());
- break;
- }
- case esSkewedBar:
- {
- if (qFuzzyIsNull(painter->pen().widthF()) && !painter->modes().testFlag(QCPPainter::pmNonCosmetic))
- {
- // if drawing with cosmetic pen (perfectly thin stroke, happens only in vector exports), draw bar exactly on tip of line
- painter->drawLine((pos+widthVec+lengthVec*0.2*(mInverted?-1:1)).toPointF(),
- (pos-widthVec-lengthVec*0.2*(mInverted?-1:1)).toPointF());
- } else
- {
- // if drawing with thick (non-cosmetic) pen, shift bar a little in line direction to prevent line from sticking through bar slightly
- painter->drawLine((pos+widthVec+lengthVec*0.2*(mInverted?-1:1)+dir.normalized()*qMax(1.0, (double)painter->pen().widthF())*0.5).toPointF(),
- (pos-widthVec-lengthVec*0.2*(mInverted?-1:1)+dir.normalized()*qMax(1.0, (double)painter->pen().widthF())*0.5).toPointF());
- }
- break;
- }
- }
- }
-
- /*! \internal
- \overload
-
- Draws the line ending. The direction is controlled with the \a angle parameter in radians.
- */
- void QCPLineEnding::draw(QCPPainter *painter, const QVector2D &pos, double angle) const
- {
- draw(painter, pos, QVector2D(qCos(angle), qSin(angle)));
- }
-
-
- ////////////////////////////////////////////////////////////////////////////////////////////////////
- //////////////////// QCPGrid
- ////////////////////////////////////////////////////////////////////////////////////////////////////
-
- /*! \class QCPGrid
- \brief Responsible for drawing the grid of a QCPAxis.
-
- This class is tightly bound to QCPAxis. Every axis owns a grid instance and uses it to draw the
- grid lines, sub grid lines and zero-line. You can interact with the grid of an axis via \ref
- QCPAxis::grid. Normally, you don't need to create an instance of QCPGrid yourself.
-
- The axis and grid drawing was split into two classes to allow them to be placed on different
- layers (both QCPAxis and QCPGrid inherit from QCPLayerable). Thus it is possible to have the grid
- in the background and the axes in the foreground, and any plottables/items in between. This
- described situation is the default setup, see the QCPLayer documentation.
- */
-
- /*!
- Creates a QCPGrid instance and sets default values.
-
- You shouldn't instantiate grids on their own, since every QCPAxis brings its own QCPGrid.
- */
- QCPGrid::QCPGrid(QCPAxis *parentAxis) :
- QCPLayerable(parentAxis->parentPlot(), "", parentAxis),
- mParentAxis(parentAxis)
- {
- // warning: this is called in QCPAxis constructor, so parentAxis members should not be accessed/called
- setParent(parentAxis);
- setPen(QPen(QColor(200,200,200), 0, Qt::DotLine));
- setSubGridPen(QPen(QColor(220,220,220), 0, Qt::DotLine));
- setZeroLinePen(QPen(QColor(200,200,200), 0, Qt::SolidLine));
- setSubGridVisible(false);
- setAntialiased(false);
- setAntialiasedSubGrid(false);
- setAntialiasedZeroLine(false);
- }
-
- /*!
- Sets whether grid lines at sub tick marks are drawn.
-
- \see setSubGridPen
- */
- void QCPGrid::setSubGridVisible(bool visible)
- {
- mSubGridVisible = visible;
- }
-
- /*!
- Sets whether sub grid lines are drawn antialiased.
- */
- void QCPGrid::setAntialiasedSubGrid(bool enabled)
- {
- mAntialiasedSubGrid = enabled;
- }
-
- /*!
- Sets whether zero lines are drawn antialiased.
- */
- void QCPGrid::setAntialiasedZeroLine(bool enabled)
- {
- mAntialiasedZeroLine = enabled;
- }
-
- /*!
- Sets the pen with which (major) grid lines are drawn.
- */
- void QCPGrid::setPen(const QPen &pen)
- {
- mPen = pen;
- }
-
- /*!
- Sets the pen with which sub grid lines are drawn.
- */
- void QCPGrid::setSubGridPen(const QPen &pen)
- {
- mSubGridPen = pen;
- }
-
- /*!
- Sets the pen with which zero lines are drawn.
-
- Zero lines are lines at value coordinate 0 which may be drawn with a different pen than other grid
- lines. To disable zero lines and just draw normal grid lines at zero, set \a pen to Qt::NoPen.
- */
- void QCPGrid::setZeroLinePen(const QPen &pen)
- {
- mZeroLinePen = pen;
- }
-
- /*! \internal
-
- A convenience function to easily set the QPainter::Antialiased hint on the provided \a painter
- before drawing the major grid lines.
-
- This is the antialiasing state the painter passed to the \ref draw method is in by default.
-
- This function takes into account the local setting of the antialiasing flag as well as the
- overrides set with \ref QCustomPlot::setAntialiasedElements and \ref
- QCustomPlot::setNotAntialiasedElements.
-
- \see setAntialiased
- */
- void QCPGrid::applyDefaultAntialiasingHint(QCPPainter *painter) const
- {
- applyAntialiasingHint(painter, mAntialiased, QCP::aeGrid);
- }
-
- /*! \internal
-
- Draws grid lines and sub grid lines at the positions of (sub) ticks of the parent axis, spanning
- over the complete axis rect. Also draws the zero line, if appropriate (\ref setZeroLinePen).
- */
- void QCPGrid::draw(QCPPainter *painter)
- {
- if (!mParentAxis) { qDebug() << Q_FUNC_INFO << "invalid parent axis"; return; }
-
- if (mSubGridVisible)
- drawSubGridLines(painter);
- drawGridLines(painter);
- }
-
- /*! \internal
-
- Draws the main grid lines and possibly a zero line with the specified painter.
-
- This is a helper function called by \ref draw.
- */
- void QCPGrid::drawGridLines(QCPPainter *painter) const
- {
- if (!mParentAxis) { qDebug() << Q_FUNC_INFO << "invalid parent axis"; return; }
-
- int lowTick = mParentAxis->mLowestVisibleTick;
- int highTick = mParentAxis->mHighestVisibleTick;
- double t; // helper variable, result of coordinate-to-pixel transforms
- if (mParentAxis->orientation() == Qt::Horizontal)
- {
- // draw zeroline:
- int zeroLineIndex = -1;
- if (mZeroLinePen.style() != Qt::NoPen && mParentAxis->mRange.lower < 0 && mParentAxis->mRange.upper > 0)
- {
- applyAntialiasingHint(painter, mAntialiasedZeroLine, QCP::aeZeroLine);
- painter->setPen(mZeroLinePen);
- double epsilon = mParentAxis->range().size()*1E-6; // for comparing double to zero
- for (int i=lowTick; i <= highTick; ++i)
- {
- if (qAbs(mParentAxis->mTickVector.at(i)) < epsilon)
- {
- zeroLineIndex = i;
- t = mParentAxis->coordToPixel(mParentAxis->mTickVector.at(i)); // x
- painter->drawLine(QLineF(t, mParentAxis->mAxisRect->bottom(), t, mParentAxis->mAxisRect->top()));
- break;
- }
- }
- }
- // draw grid lines:
- applyDefaultAntialiasingHint(painter);
- painter->setPen(mPen);
- for (int i=lowTick; i <= highTick; ++i)
- {
- if (i == zeroLineIndex) continue; // don't draw a gridline on top of the zeroline
- t = mParentAxis->coordToPixel(mParentAxis->mTickVector.at(i)); // x
- painter->drawLine(QLineF(t, mParentAxis->mAxisRect->bottom(), t, mParentAxis->mAxisRect->top()));
- }
- } else
- {
- // draw zeroline:
- int zeroLineIndex = -1;
- if (mZeroLinePen.style() != Qt::NoPen && mParentAxis->mRange.lower < 0 && mParentAxis->mRange.upper > 0)
- {
- applyAntialiasingHint(painter, mAntialiasedZeroLine, QCP::aeZeroLine);
- painter->setPen(mZeroLinePen);
- double epsilon = mParentAxis->mRange.size()*1E-6; // for comparing double to zero
- for (int i=lowTick; i <= highTick; ++i)
- {
- if (qAbs(mParentAxis->mTickVector.at(i)) < epsilon)
- {
- zeroLineIndex = i;
- t = mParentAxis->coordToPixel(mParentAxis->mTickVector.at(i)); // y
- painter->drawLine(QLineF(mParentAxis->mAxisRect->left(), t, mParentAxis->mAxisRect->right(), t));
- break;
- }
- }
- }
- // draw grid lines:
- applyDefaultAntialiasingHint(painter);
- painter->setPen(mPen);
- for (int i=lowTick; i <= highTick; ++i)
- {
- if (i == zeroLineIndex) continue; // don't draw a gridline on top of the zeroline
- t = mParentAxis->coordToPixel(mParentAxis->mTickVector.at(i)); // y
- painter->drawLine(QLineF(mParentAxis->mAxisRect->left(), t, mParentAxis->mAxisRect->right(), t));
- }
- }
- }
-
- /*! \internal
-
- Draws the sub grid lines with the specified painter.
-
- This is a helper function called by \ref draw.
- */
- void QCPGrid::drawSubGridLines(QCPPainter *painter) const
- {
- if (!mParentAxis) { qDebug() << Q_FUNC_INFO << "invalid parent axis"; return; }
-
- applyAntialiasingHint(painter, mAntialiasedSubGrid, QCP::aeSubGrid);
- double t; // helper variable, result of coordinate-to-pixel transforms
- painter->setPen(mSubGridPen);
- if (mParentAxis->orientation() == Qt::Horizontal)
- {
- for (int i=0; i<mParentAxis->mSubTickVector.size(); ++i)
- {
- t = mParentAxis->coordToPixel(mParentAxis->mSubTickVector.at(i)); // x
- painter->drawLine(QLineF(t, mParentAxis->mAxisRect->bottom(), t, mParentAxis->mAxisRect->top()));
- }
- } else
- {
- for (int i=0; i<mParentAxis->mSubTickVector.size(); ++i)
- {
- t = mParentAxis->coordToPixel(mParentAxis->mSubTickVector.at(i)); // y
- painter->drawLine(QLineF(mParentAxis->mAxisRect->left(), t, mParentAxis->mAxisRect->right(), t));
- }
- }
- }
-
-
- ////////////////////////////////////////////////////////////////////////////////////////////////////
- //////////////////// QCPAxis
- ////////////////////////////////////////////////////////////////////////////////////////////////////
-
- /*! \class QCPAxis
- \brief Manages a single axis inside a QCustomPlot.
-
- Usually doesn't need to be instantiated externally. Access %QCustomPlot's default four axes via
- QCustomPlot::xAxis (bottom), QCustomPlot::yAxis (left), QCustomPlot::xAxis2 (top) and
- QCustomPlot::yAxis2 (right).
-
- Axes are always part of an axis rect, see QCPAxisRect.
- \image html AxisNamesOverview.png
- <center>Naming convention of axis parts</center>
- \n
-
- \image html AxisRectSpacingOverview.png
- <center>Overview of the spacings and paddings that define the geometry of an axis. The dashed gray line
- on the left represents the QCustomPlot widget border.</center>
-
- */
-
- /* start of documentation of inline functions */
-
- /*! \fn Qt::Orientation QCPAxis::orientation() const
-
- Returns the orientation of the axis. The axis orientation (horizontal or vertical) is deduced
- from the axis type (left, top, right or bottom).
- */
-
- /*! \fn QCPGrid *QCPAxis::grid() const
-
- Returns the \ref QCPGrid instance belonging to this axis. Access it to set details about the way the
- grid is displayed.
- */
-
- /* end of documentation of inline functions */
- /* start of documentation of signals */
-
- /*! \fn void QCPAxis::ticksRequest()
-
- This signal is emitted when \ref setAutoTicks is false and the axis is about to generate tick
- labels for a replot.
-
- Modifying the tick positions can be done with \ref setTickVector. If you also want to control the
- tick labels, set \ref setAutoTickLabels to false and also provide the labels with \ref
- setTickVectorLabels.
-
- If you only want static ticks you probably don't need this signal, since you can just set the
- tick vector (and possibly tick label vector) once. However, if you want to provide ticks (and
- maybe labels) dynamically, e.g. depending on the current axis range, connect a slot to this
- signal and set the vector/vectors there.
- */
-
- /*! \fn void QCPAxis::rangeChanged(const QCPRange &newRange)
-
- This signal is emitted when the range of this axis has changed. You can connect it to the \ref
- setRange slot of another axis to communicate the new range to the other axis, in order for it to
- be synchronized.
- */
-
- /*! \fn void QCPAxis::rangeChanged(const QCPRange &newRange, const QCPRange &oldRange)
- \overload
-
- Additionally to the new range, this signal also provides the previous range held by the axis as
- \a oldRange.
- */
-
- /*! \fn void QCPAxis::selectionChanged(QCPAxis::SelectableParts selection)
-
- This signal is emitted when the selection state of this axis has changed, either by user interaction
- or by a direct call to \ref setSelectedParts.
- */
-
- /* end of documentation of signals */
-
- /*!
- Constructs an Axis instance of Type \a type for the axis rect \a parent.
- You shouldn't instantiate axes directly, rather use \ref QCPAxisRect::addAxis.
- */
- QCPAxis::QCPAxis(QCPAxisRect *parent, AxisType type) :
- QCPLayerable(parent->parentPlot(), "", parent),
- // axis base:
- mAxisType(type),
- mAxisRect(parent),
- mOffset(0),
- mPadding(5),
- mOrientation((type == atBottom || type == atTop) ? Qt::Horizontal : Qt::Vertical),
- mSelectableParts(spAxis | spTickLabels | spAxisLabel),
- mSelectedParts(spNone),
- mBasePen(QPen(Qt::black, 0, Qt::SolidLine, Qt::SquareCap)),
- mSelectedBasePen(QPen(Qt::blue, 2)),
- mLowerEnding(QCPLineEnding::esNone),
- mUpperEnding(QCPLineEnding::esNone),
- // axis label:
- mLabelPadding(0),
- mLabel(""),
- mLabelFont(mParentPlot->font()),
- mSelectedLabelFont(QFont(mLabelFont.family(), mLabelFont.pointSize(), QFont::Bold)),
- mLabelColor(Qt::black),
- mSelectedLabelColor(Qt::blue),
- // tick labels:
- mTickLabelPadding(0),
- mTickLabels(true),
- mAutoTickLabels(true),
- mTickLabelRotation(0),
- mTickLabelType(ltNumber),
- mTickLabelFont(mParentPlot->font()),
- mSelectedTickLabelFont(QFont(mTickLabelFont.family(), mTickLabelFont.pointSize(), QFont::Bold)),
- mTickLabelColor(Qt::black),
- mSelectedTickLabelColor(Qt::blue),
- mDateTimeFormat("hh:mm:ss\ndd.MM.yy"),
- mDateTimeSpec(Qt::LocalTime),
- mNumberPrecision(6),
- mNumberFormatChar('g'),
- mNumberBeautifulPowers(true),
- mNumberMultiplyCross(false),
- // ticks and subticks:
- mTicks(true),
- mTickStep(1),
- mSubTickCount(4),
- mAutoTickCount(6),
- mAutoTicks(true),
- mAutoTickStep(true),
- mAutoSubTicks(true),
- mTickLengthIn(5),
- mTickLengthOut(0),
- mSubTickLengthIn(2),
- mSubTickLengthOut(0),
- mTickPen(QPen(Qt::black, 0, Qt::SolidLine, Qt::SquareCap)),
- mSelectedTickPen(QPen(Qt::blue, 2)),
- mSubTickPen(QPen(Qt::black, 0, Qt::SolidLine, Qt::SquareCap)),
- mSelectedSubTickPen(QPen(Qt::blue, 2)),
- // scale and range:
- mRange(0, 5),
- mRangeReversed(false),
- mScaleType(stLinear),
- mScaleLogBase(10),
- mScaleLogBaseLogInv(1.0/qLn(mScaleLogBase)),
- // internal members:
- mGrid(new QCPGrid(this)),
- mLabelCache(16), // cache at most 16 (tick) labels
- mLowestVisibleTick(0),
- mHighestVisibleTick(-1),
- mExponentialChar('e'), // will be updated with locale sensitive values in setupTickVector
- mPositiveSignChar('+'), // will be updated with locale sensitive values in setupTickVector
- mCachedMarginValid(false),
- mCachedMargin(0)
- {
- mGrid->setVisible(false);
- setAntialiased(false);
- setLayer(mParentPlot->currentLayer()); // it's actually on that layer already, but we want it in front of the grid, so we place it on there again
-
- if (type == atTop)
- {
- setTickLabelPadding(3);
- setLabelPadding(6);
- } else if (type == atRight)
- {
- setTickLabelPadding(7);
- setLabelPadding(12);
- } else if (type == atBottom)
- {
- setTickLabelPadding(3);
- setLabelPadding(3);
- } else if (type == atLeft)
- {
- setTickLabelPadding(5);
- setLabelPadding(10);
- }
- }
-
- /* No documentation as it is a property getter */
- QString QCPAxis::numberFormat() const
- {
- QString result;
- result.append(mNumberFormatChar);
- if (mNumberBeautifulPowers)
- {
- result.append("b");
- if (mNumberMultiplyCross)
- result.append("c");
- }
- return result;
- }
-
- /*!
- Sets whether the axis uses a linear scale or a logarithmic scale. If \a type is set to \ref
- stLogarithmic, the logarithm base can be set with \ref setScaleLogBase. In logarithmic axis
- scaling, major tick marks appear at all powers of the logarithm base. Properties like tick step
- (\ref setTickStep) don't apply in logarithmic scaling. If you wish a decimal base but less major
- ticks, consider choosing a logarithm base of 100, 1000 or even higher.
-
- If \a type is \ref stLogarithmic and the number format (\ref setNumberFormat) uses the 'b' option
- (beautifully typeset decimal powers), the display usually is "1 [multiplication sign] 10
- [superscript] n", which looks unnatural for logarithmic scaling (the "1 [multiplication sign]"
- part). To only display the decimal power, set the number precision to zero with
- \ref setNumberPrecision.
- */
- void QCPAxis::setScaleType(ScaleType type)
- {
- if (mScaleType != type)
- {
- mScaleType = type;
- if (mScaleType == stLogarithmic)
- mRange = mRange.sanitizedForLogScale();
- mCachedMarginValid = false;
- }
- }
-
- /*!
- If \ref setScaleType is set to \ref stLogarithmic, \a base will be the logarithm base of the
- scaling. In logarithmic axis scaling, major tick marks appear at all powers of \a base.
-
- Properties like tick step (\ref setTickStep) don't apply in logarithmic scaling. If you wish a decimal base but
- less major ticks, consider choosing \a base 100, 1000 or even higher.
- */
- void QCPAxis::setScaleLogBase(double base)
- {
- if (base > 1)
- {
- mScaleLogBase = base;
- mScaleLogBaseLogInv = 1.0/qLn(mScaleLogBase); // buffer for faster baseLog() calculation
- mCachedMarginValid = false;
- } else
- qDebug() << Q_FUNC_INFO << "Invalid logarithmic scale base (must be greater 1):" << base;
- }
-
- /*!
- Sets the range of the axis.
-
- This slot may be connected with the \ref rangeChanged signal of another axis so this axis
- is always synchronized with the other axis range, when it changes.
-
- To invert the direction of an axis, use \ref setRangeReversed.
- */
- void QCPAxis::setRange(const QCPRange &range)
- {
- if (range.lower == mRange.lower && range.upper == mRange.upper)
- return;
-
- if (!QCPRange::validRange(range)) return;
- QCPRange oldRange = mRange;
- if (mScaleType == stLogarithmic)
- {
- mRange = range.sanitizedForLogScale();
- } else
- {
- mRange = range.sanitizedForLinScale();
- }
- mCachedMarginValid = false;
- emit rangeChanged(mRange);
- emit rangeChanged(mRange, oldRange);
- }
-
- /*!
- Sets whether the user can (de-)select the parts in \a selectable by clicking on the QCustomPlot surface.
- (When \ref QCustomPlot::setInteractions contains iSelectAxes.)
-
- However, even when \a selectable is set to a value not allowing the selection of a specific part,
- it is still possible to set the selection of this part manually, by calling \ref setSelectedParts
- directly.
-
- \see SelectablePart, setSelectedParts
- */
- void QCPAxis::setSelectableParts(const SelectableParts &selectable)
- {
- mSelectableParts = selectable;
- }
-
- /*!
- Sets the selected state of the respective axis parts described by \ref SelectablePart. When a part
- is selected, it uses a different pen/font.
-
- The entire selection mechanism for axes is handled automatically when \ref
- QCustomPlot::setInteractions contains iSelectAxes. You only need to call this function when you
- wish to change the selection state manually.
-
- This function can change the selection state of a part, independent of the \ref setSelectableParts setting.
-
- emits the \ref selectionChanged signal when \a selected is different from the previous selection state.
-
- \see SelectablePart, setSelectableParts, selectTest, setSelectedBasePen, setSelectedTickPen, setSelectedSubTickPen,
- setSelectedTickLabelFont, setSelectedLabelFont, setSelectedTickLabelColor, setSelectedLabelColor
- */
- void QCPAxis::setSelectedParts(const SelectableParts &selected)
- {
- if (mSelectedParts != selected)
- {
- if (mSelectedParts.testFlag(spTickLabels) != selected.testFlag(spTickLabels))
- mLabelCache.clear();
- mSelectedParts = selected;
- emit selectionChanged(mSelectedParts);
- }
- }
-
- /*!
- \overload
-
- Sets the lower and upper bound of the axis range.
-
- To invert the direction of an axis, use \ref setRangeReversed.
-
- There is also a slot to set a range, see \ref setRange(const QCPRange &range).
- */
- void QCPAxis::setRange(double lower, double upper)
- {
- if (lower == mRange.lower && upper == mRange.upper)
- return;
-
- if (!QCPRange::validRange(lower, upper)) return;
- QCPRange oldRange = mRange;
- mRange.lower = lower;
- mRange.upper = upper;
- if (mScaleType == stLogarithmic)
- {
- mRange = mRange.sanitizedForLogScale();
- } else
- {
- mRange = mRange.sanitizedForLinScale();
- }
- mCachedMarginValid = false;
- emit rangeChanged(mRange);
- emit rangeChanged(mRange, oldRange);
- }
-
- /*!
- \overload
-
- Sets the range of the axis.
-
- The \a position coordinate indicates together with the \a alignment parameter, where the new
- range will be positioned. \a size defines the size of the new axis range. \a alignment may be
- Qt::AlignLeft, Qt::AlignRight or Qt::AlignCenter. This will cause the left border, right border,
- or center of the range to be aligned with \a position. Any other values of \a alignment will
- default to Qt::AlignCenter.
- */
- void QCPAxis::setRange(double position, double size, Qt::AlignmentFlag alignment)
- {
- if (alignment == Qt::AlignLeft)
- setRange(position, position+size);
- else if (alignment == Qt::AlignRight)
- setRange(position-size, position);
- else // alignment == Qt::AlignCenter
- setRange(position-size/2.0, position+size/2.0);
- }
-
- /*!
- Sets the lower bound of the axis range. The upper bound is not changed.
- \see setRange
- */
- void QCPAxis::setRangeLower(double lower)
- {
- if (mRange.lower == lower)
- return;
-
- QCPRange oldRange = mRange;
- mRange.lower = lower;
- if (mScaleType == stLogarithmic)
- {
- mRange = mRange.sanitizedForLogScale();
- } else
- {
- mRange = mRange.sanitizedForLinScale();
- }
- mCachedMarginValid = false;
- emit rangeChanged(mRange);
- emit rangeChanged(mRange, oldRange);
- }
-
- /*!
- Sets the upper bound of the axis range. The lower bound is not changed.
- \see setRange
- */
- void QCPAxis::setRangeUpper(double upper)
- {
- if (mRange.upper == upper)
- return;
-
- QCPRange oldRange = mRange;
- mRange.upper = upper;
- if (mScaleType == stLogarithmic)
- {
- mRange = mRange.sanitizedForLogScale();
- } else
- {
- mRange = mRange.sanitizedForLinScale();
- }
- mCachedMarginValid = false;
- emit rangeChanged(mRange);
- emit rangeChanged(mRange, oldRange);
- }
-
- /*!
- Sets whether the axis range (direction) is displayed reversed. Normally, the values on horizontal
- axes increase left to right, on vertical axes bottom to top. When \a reversed is set to true, the
- direction of increasing values is inverted.
-
- Note that the range and data interface stays the same for reversed axes, e.g. the \a lower part
- of the \ref setRange interface will still reference the mathematically smaller number than the \a
- upper part.
- */
- void QCPAxis::setRangeReversed(bool reversed)
- {
- if (mRangeReversed != reversed)
- {
- mRangeReversed = reversed;
- mCachedMarginValid = false;
- }
- }
-
- /*!
- Sets whether the tick positions should be calculated automatically (either from an automatically
- generated tick step or a tick step provided manually via \ref setTickStep, see \ref setAutoTickStep).
-
- If \a on is set to false, you must provide the tick positions manually via \ref setTickVector.
- For these manual ticks you may let QCPAxis generate the appropriate labels automatically by
- leaving \ref setAutoTickLabels set to true. If you also wish to control the displayed labels
- manually, set \ref setAutoTickLabels to false and provide the label strings with \ref
- setTickVectorLabels.
-
- If you need dynamically calculated tick vectors (and possibly tick label vectors), set the
- vectors in a slot connected to the \ref ticksRequest signal.
- */
- void QCPAxis::setAutoTicks(bool on)
- {
- if (mAutoTicks != on)
- {
- mAutoTicks = on;
- mCachedMarginValid = false;
- }
- }
-
- /*!
- When \ref setAutoTickStep is true, \a approximateCount determines how many ticks should be
- generated in the visible range, approximately.
-
- It's not guaranteed that this number of ticks is met exactly, but approximately within a
- tolerance of about two.
-
- Only values greater than zero are accepted as \a approximateCount.
- */
- void QCPAxis::setAutoTickCount(int approximateCount)
- {
- if (mAutoTickCount != approximateCount)
- {
- if (approximateCount > 0)
- {
- mAutoTickCount = approximateCount;
- mCachedMarginValid = false;
- } else
- qDebug() << Q_FUNC_INFO << "approximateCount must be greater than zero:" << approximateCount;
- }
- }
-
- /*!
- Sets whether the tick labels are generated automatically. Depending on the tick label type (\ref
- ltNumber or \ref ltDateTime), the labels will either show the coordinate as floating point
- number (\ref setNumberFormat), or a date/time formatted according to \ref setDateTimeFormat.
-
- If \a on is set to false, you should provide the tick labels via \ref setTickVectorLabels. This
- is usually used in a combination with \ref setAutoTicks set to false for complete control over
- tick positions and labels, e.g. when the ticks should be at multiples of pi and show "2pi", "3pi"
- etc. as tick labels.
-
- If you need dynamically calculated tick vectors (and possibly tick label vectors), set the
- vectors in a slot connected to the \ref ticksRequest signal.
- */
- void QCPAxis::setAutoTickLabels(bool on)
- {
- if (mAutoTickLabels != on)
- {
- mAutoTickLabels = on;
- mCachedMarginValid = false;
- }
- }
-
- /*!
- Sets whether the tick step, i.e. the interval between two (major) ticks, is calculated
- automatically. If \a on is set to true, the axis finds a tick step that is reasonable for human
- readable plots.
-
- The number of ticks the algorithm aims for within the visible range can be set with \ref
- setAutoTickCount.
-
- If \a on is set to false, you may set the tick step manually with \ref setTickStep.
- */
- void QCPAxis::setAutoTickStep(bool on)
- {
- if (mAutoTickStep != on)
- {
- mAutoTickStep = on;
- mCachedMarginValid = false;
- }
- }
-
- /*!
- Sets whether the number of sub ticks in one tick interval is determined automatically. This
- works, as long as the tick step mantissa is a multiple of 0.5. When \ref setAutoTickStep is
- enabled, this is always the case.
-
- When \a on is set to false, you may set the sub tick count with \ref setSubTickCount manually.
- */
- void QCPAxis::setAutoSubTicks(bool on)
- {
- if (mAutoSubTicks != on)
- {
- mAutoSubTicks = on;
- mCachedMarginValid = false;
- }
- }
-
- /*!
- Sets whether tick marks are displayed.
-
- Note that setting \a show to false does not imply that tick labels are invisible, too. To achieve
- that, see \ref setTickLabels.
- */
- void QCPAxis::setTicks(bool show)
- {
- if (mTicks != show)
- {
- mTicks = show;
- mCachedMarginValid = false;
- }
- }
-
- /*!
- Sets whether tick labels are displayed. Tick labels are the numbers drawn next to tick marks.
- */
- void QCPAxis::setTickLabels(bool show)
- {
- if (mTickLabels != show)
- {
- mTickLabels = show;
- mCachedMarginValid = false;
- }
- }
-
- /*!
- Sets the distance between the axis base line (including any outward ticks) and the tick labels.
- \see setLabelPadding, setPadding
- */
- void QCPAxis::setTickLabelPadding(int padding)
- {
- if (mTickLabelPadding != padding)
- {
- mTickLabelPadding = padding;
- mCachedMarginValid = false;
- }
- }
-
- /*!
- Sets whether the tick labels display numbers or dates/times.
-
- If \a type is set to \ref ltNumber, the format specifications of \ref setNumberFormat apply.
-
- If \a type is set to \ref ltDateTime, the format specifications of \ref setDateTimeFormat apply.
-
- In QCustomPlot, date/time coordinates are <tt>double</tt> numbers representing the seconds since
- 1970-01-01T00:00:00 UTC. This format can be retrieved from QDateTime objects with the
- QDateTime::toTime_t() function. Since this only gives a resolution of one second, there is also
- the QDateTime::toMSecsSinceEpoch() function which returns the timespan described above in
- milliseconds. Divide its return value by 1000.0 to get a value with the format needed for
- date/time plotting, with a resolution of one millisecond.
-
- Using the toMSecsSinceEpoch function allows dates that go back to 2nd January 4713 B.C.
- (represented by a negative number), unlike the toTime_t function, which works with unsigned
- integers and thus only goes back to 1st January 1970. So both for range and accuracy, use of
- toMSecsSinceEpoch()/1000.0 should be preferred as key coordinate for date/time axes.
-
- \see setTickLabels
- */
- void QCPAxis::setTickLabelType(LabelType type)
- {
- if (mTickLabelType != type)
- {
- mTickLabelType = type;
- mCachedMarginValid = false;
- }
- }
-
- /*!
- Sets the font of the tick labels.
-
- \see setTickLabels, setTickLabelColor
- */
- void QCPAxis::setTickLabelFont(const QFont &font)
- {
- if (font != mTickLabelFont)
- {
- mTickLabelFont = font;
- mCachedMarginValid = false;
- mLabelCache.clear();
- }
- }
-
- /*!
- Sets the color of the tick labels.
-
- \see setTickLabels, setTickLabelFont
- */
- void QCPAxis::setTickLabelColor(const QColor &color)
- {
- if (color != mTickLabelColor)
- {
- mTickLabelColor = color;
- mCachedMarginValid = false;
- mLabelCache.clear();
- }
- }
-
- /*!
- Sets the rotation of the tick labels. If \a degrees is zero, the labels are drawn normally. Else,
- the tick labels are drawn rotated by \a degrees clockwise. The specified angle is bound to values
- from -90 to 90 degrees.
-
- If \a degrees is exactly -90, 0 or 90, the tick labels are centered on the tick coordinate. For
- other angles, the label is drawn with an offset such that it seems to point toward or away from
- the tick mark.
- */
- void QCPAxis::setTickLabelRotation(double degrees)
- {
- if (!qFuzzyIsNull(degrees-mTickLabelRotation))
- {
- mTickLabelRotation = qBound(-90.0, degrees, 90.0);
- mCachedMarginValid = false;
- mLabelCache.clear();
- }
- }
-
- /*!
- Sets the format in which dates and times are displayed as tick labels, if \ref setTickLabelType is \ref ltDateTime.
- for details about the \a format string, see the documentation of QDateTime::toString().
-
- Newlines can be inserted with "\n".
-
- \see setDateTimeSpec
- */
- void QCPAxis::setDateTimeFormat(const QString &format)
- {
- if (mDateTimeFormat != format)
- {
- mDateTimeFormat = format;
- mCachedMarginValid = false;
- mLabelCache.clear();
- }
- }
-
- /*!
- Sets the time spec that is used for the date time values when \ref setTickLabelType is \ref
- ltDateTime.
-
- The default value of QDateTime objects (and also QCustomPlot) is <tt>Qt::LocalTime</tt>. However,
- if the date time values passed to QCustomPlot are given in the UTC spec, set \a
- timeSpec to <tt>Qt::UTC</tt> to get the correct axis labels.
-
- \see setDateTimeFormat
- */
- void QCPAxis::setDateTimeSpec(const Qt::TimeSpec &timeSpec)
- {
- mDateTimeSpec = timeSpec;
- }
-
- /*!
- Sets the number format for the numbers drawn as tick labels (if tick label type is \ref
- ltNumber). This \a formatCode is an extended version of the format code used e.g. by
- QString::number() and QLocale::toString(). For reference about that, see the "Argument Formats"
- section in the detailed description of the QString class. \a formatCode is a string of one, two
- or three characters. The first character is identical to the normal format code used by Qt. In
- short, this means: 'e'/'E' scientific format, 'f' fixed format, 'g'/'G' scientific or fixed,
- whichever is shorter.
-
- The second and third characters are optional and specific to QCustomPlot:\n
- If the first char was 'e' or 'g', numbers are/might be displayed in the scientific format, e.g.
- "5.5e9", which is ugly in a plot. So when the second char of \a formatCode is set to 'b' (for
- "beautiful"), those exponential numbers are formatted in a more natural way, i.e. "5.5
- [multiplication sign] 10 [superscript] 9". By default, the multiplication sign is a centered dot.
- If instead a cross should be shown (as is usual in the USA), the third char of \a formatCode can
- be set to 'c'. The inserted multiplication signs are the UTF-8 characters 215 (0xD7) for the
- cross and 183 (0xB7) for the dot.
-
- If the scale type (\ref setScaleType) is \ref stLogarithmic and the \a formatCode uses the 'b'
- option (beautifully typeset decimal powers), the display usually is "1 [multiplication sign] 10
- [superscript] n", which looks unnatural for logarithmic scaling (the "1 [multiplication sign]"
- part). To only display the decimal power, set the number precision to zero with \ref
- setNumberPrecision.
-
- Examples for \a formatCode:
- \li \c g normal format code behaviour. If number is small, fixed format is used, if number is large,
- normal scientific format is used
- \li \c gb If number is small, fixed format is used, if number is large, scientific format is used with
- beautifully typeset decimal powers and a dot as multiplication sign
- \li \c ebc All numbers are in scientific format with beautifully typeset decimal power and a cross as
- multiplication sign
- \li \c fb illegal format code, since fixed format doesn't support (or need) beautifully typeset decimal
- powers. Format code will be reduced to 'f'.
- \li \c hello illegal format code, since first char is not 'e', 'E', 'f', 'g' or 'G'. Current format
- code will not be changed.
- */
- void QCPAxis::setNumberFormat(const QString &formatCode)
- {
- if (formatCode.isEmpty())
- {
- qDebug() << Q_FUNC_INFO << "Passed formatCode is empty";
- return;
- }
- mLabelCache.clear();
- mCachedMarginValid = false;
-
- // interpret first char as number format char:
- QString allowedFormatChars = "eEfgG";
- if (allowedFormatChars.contains(formatCode.at(0)))
- {
- mNumberFormatChar = formatCode.at(0).toLatin1();
- } else
- {
- qDebug() << Q_FUNC_INFO << "Invalid number format code (first char not in 'eEfgG'):" << formatCode;
- return;
- }
- if (formatCode.length() < 2)
- {
- mNumberBeautifulPowers = false;
- mNumberMultiplyCross = false;
- return;
- }
-
- // interpret second char as indicator for beautiful decimal powers:
- if (formatCode.at(1) == 'b' && (mNumberFormatChar == 'e' || mNumberFormatChar == 'g'))
- {
- mNumberBeautifulPowers = true;
- } else
- {
- qDebug() << Q_FUNC_INFO << "Invalid number format code (second char not 'b' or first char neither 'e' nor 'g'):" << formatCode;
- return;
- }
- if (formatCode.length() < 3)
- {
- mNumberMultiplyCross = false;
- return;
- }
-
- // interpret third char as indicator for dot or cross multiplication symbol:
- if (formatCode.at(2) == 'c')
- {
- mNumberMultiplyCross = true;
- } else if (formatCode.at(2) == 'd')
- {
- mNumberMultiplyCross = false;
- } else
- {
- qDebug() << Q_FUNC_INFO << "Invalid number format code (third char neither 'c' nor 'd'):" << formatCode;
- return;
- }
- }
-
- /*!
- Sets the precision of the tick label numbers. See QLocale::toString(double i, char f, int prec)
- for details. The effect of precisions are most notably for number Formats starting with 'e', see
- \ref setNumberFormat
-
- If the scale type (\ref setScaleType) is \ref stLogarithmic and the number format (\ref
- setNumberFormat) uses the 'b' format code (beautifully typeset decimal powers), the display
- usually is "1 [multiplication sign] 10 [superscript] n", which looks unnatural for logarithmic
- scaling (the redundant "1 [multiplication sign]" part). To only display the decimal power "10
- [superscript] n", set \a precision to zero.
- */
- void QCPAxis::setNumberPrecision(int precision)
- {
- if (mNumberPrecision != precision)
- {
- mNumberPrecision = precision;
- mCachedMarginValid = false;
- }
- }
-
- /*!
- If \ref setAutoTickStep is set to false, use this function to set the tick step manually.
- The tick step is the interval between (major) ticks, in plot coordinates.
- \see setSubTickCount
- */
- void QCPAxis::setTickStep(double step)
- {
- if (mTickStep != step)
- {
- mTickStep = step;
- mCachedMarginValid = false;
- }
- }
-
- /*!
- If you want full control over what ticks (and possibly labels) the axes show, this function is
- used to set the coordinates at which ticks will appear.\ref setAutoTicks must be disabled, else
- the provided tick vector will be overwritten with automatically generated tick coordinates upon
- replot. The labels of the ticks can be generated automatically when \ref setAutoTickLabels is
- left enabled. If it is disabled, you can set the labels manually with \ref setTickVectorLabels.
-
- \a vec is a vector containing the positions of the ticks, in plot coordinates.
-
- \warning \a vec must be sorted in ascending order, no additional checks are made to ensure this.
-
- \see setTickVectorLabels
- */
- void QCPAxis::setTickVector(const QVector<double> &vec)
- {
- // don't check whether mTickVector != vec here, because it takes longer than we would save
- mTickVector = vec;
- mCachedMarginValid = false;
- }
-
- /*!
- If you want full control over what ticks and labels the axes show, this function is used to set a
- number of QStrings that will be displayed at the tick positions which you need to provide with
- \ref setTickVector. These two vectors should have the same size. (Note that you need to disable
- \ref setAutoTicks and \ref setAutoTickLabels first.)
-
- \a vec is a vector containing the labels of the ticks. The entries correspond to the respective
- indices in the tick vector, passed via \ref setTickVector.
-
- \see setTickVector
- */
- void QCPAxis::setTickVectorLabels(const QVector<QString> &vec)
- {
- // don't check whether mTickVectorLabels != vec here, because it takes longer than we would save
- mTickVectorLabels = vec;
- mCachedMarginValid = false;
- }
-
- /*!
- Sets the length of the ticks in pixels. \a inside is the length the ticks will reach inside the
- plot and \a outside is the length they will reach outside the plot. If \a outside is greater than
- zero, the tick labels and axis label will increase their distance to the axis accordingly, so
- they won't collide with the ticks.
-
- \see setSubTickLength
- */
- void QCPAxis::setTickLength(int inside, int outside)
- {
- if (mTickLengthIn != inside)
- {
- mTickLengthIn = inside;
- }
- if (mTickLengthOut != outside)
- {
- mTickLengthOut = outside;
- mCachedMarginValid = false; // only outside tick length can change margin
- }
- }
-
- /*!
- Sets the length of the inward ticks in pixels. \a inside is the length the ticks will reach
- inside the plot.
-
- \see setTickLengthOut, setSubTickLength
- */
- void QCPAxis::setTickLengthIn(int inside)
- {
- if (mTickLengthIn != inside)
- {
- mTickLengthIn = inside;
- }
- }
-
- /*!
- Sets the length of the outward ticks in pixels. \a outside is the length the ticks will reach
- outside the plot. If \a outside is greater than zero, the tick labels and axis label will
- increase their distance to the axis accordingly, so they won't collide with the ticks.
-
- \see setTickLengthIn, setSubTickLength
- */
- void QCPAxis::setTickLengthOut(int outside)
- {
- if (mTickLengthOut != outside)
- {
- mTickLengthOut = outside;
- mCachedMarginValid = false; // only outside tick length can change margin
- }
- }
-
- /*!
- Sets the number of sub ticks in one (major) tick step. A sub tick count of three for example,
- divides the tick intervals in four sub intervals.
-
- By default, the number of sub ticks is chosen automatically in a reasonable manner as long as the
- mantissa of the tick step is a multiple of 0.5. When \ref setAutoTickStep is enabled, this is
- always the case.
-
- If you want to disable automatic sub tick count and use this function to set the count manually,
- see \ref setAutoSubTicks.
- */
- void QCPAxis::setSubTickCount(int count)
- {
- mSubTickCount = count;
- }
-
- /*!
- Sets the length of the subticks in pixels. \a inside is the length the subticks will reach inside
- the plot and \a outside is the length they will reach outside the plot. If \a outside is greater
- than zero, the tick labels and axis label will increase their distance to the axis accordingly,
- so they won't collide with the ticks.
- */
- void QCPAxis::setSubTickLength(int inside, int outside)
- {
- if (mSubTickLengthIn != inside)
- {
- mSubTickLengthIn = inside;
- }
- if (mSubTickLengthOut != outside)
- {
- mSubTickLengthOut = outside;
- mCachedMarginValid = false; // only outside tick length can change margin
- }
- }
-
- /*!
- Sets the length of the inward subticks in pixels. \a inside is the length the subticks will reach inside
- the plot.
-
- \see setSubTickLengthOut, setTickLength
- */
- void QCPAxis::setSubTickLengthIn(int inside)
- {
- if (mSubTickLengthIn != inside)
- {
- mSubTickLengthIn = inside;
- }
- }
-
- /*!
- Sets the length of the outward subticks in pixels. \a outside is the length the subticks will reach
- outside the plot. If \a outside is greater than zero, the tick labels will increase their
- distance to the axis accordingly, so they won't collide with the ticks.
-
- \see setSubTickLengthIn, setTickLength
- */
- void QCPAxis::setSubTickLengthOut(int outside)
- {
- if (mSubTickLengthOut != outside)
- {
- mSubTickLengthOut = outside;
- mCachedMarginValid = false; // only outside tick length can change margin
- }
- }
-
- /*!
- Sets the pen, the axis base line is drawn with.
-
- \see setTickPen, setSubTickPen
- */
- void QCPAxis::setBasePen(const QPen &pen)
- {
- mBasePen = pen;
- }
-
- /*!
- Sets the pen, tick marks will be drawn with.
-
- \see setTickLength, setBasePen
- */
- void QCPAxis::setTickPen(const QPen &pen)
- {
- mTickPen = pen;
- }
-
- /*!
- Sets the pen, subtick marks will be drawn with.
-
- \see setSubTickCount, setSubTickLength, setBasePen
- */
- void QCPAxis::setSubTickPen(const QPen &pen)
- {
- mSubTickPen = pen;
- }
-
- /*!
- Sets the font of the axis label.
-
- \see setLabelColor
- */
- void QCPAxis::setLabelFont(const QFont &font)
- {
- if (mLabelFont != font)
- {
- mLabelFont = font;
- mCachedMarginValid = false;
- }
- }
-
- /*!
- Sets the color of the axis label.
-
- \see setLabelFont
- */
- void QCPAxis::setLabelColor(const QColor &color)
- {
- mLabelColor = color;
- }
-
- /*!
- Sets the text of the axis label that will be shown below/above or next to the axis, depending on
- its orientation. To disable axis labels, pass an empty string as \a str.
- */
- void QCPAxis::setLabel(const QString &str)
- {
- if (mLabel != str)
- {
- mLabel = str;
- mCachedMarginValid = false;
- }
- }
-
- /*!
- Sets the distance between the tick labels and the axis label.
-
- \see setTickLabelPadding, setPadding
- */
- void QCPAxis::setLabelPadding(int padding)
- {
- if (mLabelPadding != padding)
- {
- mLabelPadding = padding;
- mCachedMarginValid = false;
- }
- }
-
- /*!
- Sets the padding of the axis.
-
- When \ref QCPAxisRect::setAutoMargins is enabled, the padding is the additional outer most space,
- that is left blank.
-
- The axis padding has no meaning if \ref QCPAxisRect::setAutoMargins is disabled.
-
- \see setLabelPadding, setTickLabelPadding
- */
- void QCPAxis::setPadding(int padding)
- {
- if (mPadding != padding)
- {
- mPadding = padding;
- mCachedMarginValid = false;
- }
- }
-
- /*!
- Sets the offset the axis has to its axis rect side.
-
- If an axis rect side has multiple axes, only the offset of the inner most axis has meaning. The offset of the other axes
- is controlled automatically, to place the axes at appropriate positions to prevent them from overlapping.
- */
- void QCPAxis::setOffset(int offset)
- {
- mOffset = offset;
- }
-
- /*!
- Sets the font that is used for tick labels when they are selected.
-
- \see setTickLabelFont, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions
- */
- void QCPAxis::setSelectedTickLabelFont(const QFont &font)
- {
- if (font != mSelectedTickLabelFont)
- {
- mSelectedTickLabelFont = font;
- mLabelCache.clear();
- // don't set mCachedMarginValid to false here because margin calculation is always done with non-selected fonts
- }
- }
-
- /*!
- Sets the font that is used for the axis label when it is selected.
-
- \see setLabelFont, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions
- */
- void QCPAxis::setSelectedLabelFont(const QFont &font)
- {
- mSelectedLabelFont = font;
- // don't set mCachedMarginValid to false here because margin calculation is always done with non-selected fonts
- }
-
- /*!
- Sets the color that is used for tick labels when they are selected.
-
- \see setTickLabelColor, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions
- */
- void QCPAxis::setSelectedTickLabelColor(const QColor &color)
- {
- if (color != mSelectedTickLabelColor)
- {
- mSelectedTickLabelColor = color;
- mLabelCache.clear();
- }
- }
-
- /*!
- Sets the color that is used for the axis label when it is selected.
-
- \see setLabelColor, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions
- */
- void QCPAxis::setSelectedLabelColor(const QColor &color)
- {
- mSelectedLabelColor = color;
- }
-
- /*!
- Sets the pen that is used to draw the axis base line when selected.
-
- \see setBasePen, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions
- */
- void QCPAxis::setSelectedBasePen(const QPen &pen)
- {
- mSelectedBasePen = pen;
- }
-
- /*!
- Sets the pen that is used to draw the (major) ticks when selected.
-
- \see setTickPen, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions
- */
- void QCPAxis::setSelectedTickPen(const QPen &pen)
- {
- mSelectedTickPen = pen;
- }
-
- /*!
- Sets the pen that is used to draw the subticks when selected.
-
- \see setSubTickPen, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions
- */
- void QCPAxis::setSelectedSubTickPen(const QPen &pen)
- {
- mSelectedSubTickPen = pen;
- }
-
- /*!
- Sets the style for the lower axis ending. See the documentation of QCPLineEnding for available
- styles.
-
- For horizontal axes, this method refers to the left ending, for vertical axes the bottom ending.
- Note that this meaning does not change when the axis range is reversed with \ref
- setRangeReversed.
-
- \see setUpperEnding
- */
- void QCPAxis::setLowerEnding(const QCPLineEnding &ending)
- {
- mLowerEnding = ending;
- }
-
- /*!
- Sets the style for the upper axis ending. See the documentation of QCPLineEnding for available
- styles.
-
- For horizontal axes, this method refers to the right ending, for vertical axes the top ending.
- Note that this meaning does not change when the axis range is reversed with \ref
- setRangeReversed.
-
- \see setLowerEnding
- */
- void QCPAxis::setUpperEnding(const QCPLineEnding &ending)
- {
- mUpperEnding = ending;
- }
-
- /*!
- If the scale type (\ref setScaleType) is \ref stLinear, \a diff is added to the lower and upper
- bounds of the range. The range is simply moved by \a diff.
-
- If the scale type is \ref stLogarithmic, the range bounds are multiplied by \a diff. This
- corresponds to an apparent "linear" move in logarithmic scaling by a distance of log(diff).
- */
- void QCPAxis::moveRange(double diff)
- {
- QCPRange oldRange = mRange;
- if (mScaleType == stLinear)
- {
- mRange.lower += diff;
- mRange.upper += diff;
- } else // mScaleType == stLogarithmic
- {
- mRange.lower *= diff;
- mRange.upper *= diff;
- }
- mCachedMarginValid = false;
- emit rangeChanged(mRange);
- emit rangeChanged(mRange, oldRange);
- }
-
- /*!
- Scales the range of this axis by \a factor around the coordinate \a center. For example, if \a
- factor is 2.0, \a center is 1.0, then the axis range will double its size, and the point at
- coordinate 1.0 won't have changed its position in the QCustomPlot widget (i.e. coordinates
- around 1.0 will have moved symmetrically closer to 1.0).
- */
- void QCPAxis::scaleRange(double factor, double center)
- {
- QCPRange oldRange = mRange;
- if (mScaleType == stLinear)
- {
- QCPRange newRange;
- newRange.lower = (mRange.lower-center)*factor + center;
- newRange.upper = (mRange.upper-center)*factor + center;
- if (QCPRange::validRange(newRange))
- mRange = newRange.sanitizedForLinScale();
- } else // mScaleType == stLogarithmic
- {
- if ((mRange.upper < 0 && center < 0) || (mRange.upper > 0 && center > 0)) // make sure center has same sign as range
- {
- QCPRange newRange;
- newRange.lower = pow(mRange.lower/center, factor)*center;
- newRange.upper = pow(mRange.upper/center, factor)*center;
- if (QCPRange::validRange(newRange))
- mRange = newRange.sanitizedForLogScale();
- } else
- qDebug() << Q_FUNC_INFO << "Center of scaling operation doesn't lie in same logarithmic sign domain as range:" << center;
- }
- mCachedMarginValid = false;
- emit rangeChanged(mRange);
- emit rangeChanged(mRange, oldRange);
- }
-
- /*!
- Scales the range of this axis to have a certain scale \a ratio to \a otherAxis. The scaling will
- be done around the center of the current axis range.
-
- For example, if \a ratio is 1, this axis is the \a yAxis and \a otherAxis is \a xAxis, graphs
- plotted with those axes will appear in a 1:1 aspect ratio, independent of the aspect ratio the
- axis rect has.
-
- This is an operation that changes the range of this axis once, it doesn't fix the scale ratio
- indefinitely. Note that calling this function in the constructor of the QCustomPlot's parent
- won't have the desired effect, since the widget dimensions aren't defined yet, and a resizeEvent
- will follow.
- */
- void QCPAxis::setScaleRatio(const QCPAxis *otherAxis, double ratio)
- {
- int otherPixelSize, ownPixelSize;
-
- if (otherAxis->orientation() == Qt::Horizontal)
- otherPixelSize = otherAxis->axisRect()->width();
- else
- otherPixelSize = otherAxis->axisRect()->height();
-
- if (orientation() == Qt::Horizontal)
- ownPixelSize = axisRect()->width();
- else
- ownPixelSize = axisRect()->height();
-
- double newRangeSize = ratio*otherAxis->range().size()*ownPixelSize/(double)otherPixelSize;
- setRange(range().center(), newRangeSize, Qt::AlignCenter);
- }
-
- /*!
- Changes the axis range such that all plottables associated with this axis are fully visible in
- that dimension.
-
- \see QCPAbstractPlottable::rescaleAxes, QCustomPlot::rescaleAxes
- */
- void QCPAxis::rescale(bool onlyVisiblePlottables)
- {
- QList<QCPAbstractPlottable*> p = plottables();
- QCPRange newRange;
- bool haveRange = false;
- for (int i=0; i<p.size(); ++i)
- {
- if (!p.at(i)->realVisibility() && onlyVisiblePlottables)
- continue;
- QCPRange plottableRange;
- bool validRange;
- QCPAbstractPlottable::SignDomain signDomain = QCPAbstractPlottable::sdBoth;
- if (mScaleType == stLogarithmic)
- signDomain = (mRange.upper < 0 ? QCPAbstractPlottable::sdNegative : QCPAbstractPlottable::sdPositive);
- if (p.at(i)->keyAxis() == this)
- plottableRange = p.at(i)->getKeyRange(validRange, signDomain);
- else
- plottableRange = p.at(i)->getValueRange(validRange, signDomain);
- if (validRange)
- {
- if (!haveRange)
- newRange = plottableRange;
- else
- newRange.expand(plottableRange);
- haveRange = true;
- }
- }
- if (haveRange)
- setRange(newRange);
- }
-
- /*!
- Transforms \a value, in pixel coordinates of the QCustomPlot widget, to axis coordinates.
- */
- double QCPAxis::pixelToCoord(double value) const
- {
- if (orientation() == Qt::Horizontal)
- {
- if (mScaleType == stLinear)
- {
- if (!mRangeReversed)
- return (value-mAxisRect->left())/(double)mAxisRect->width()*mRange.size()+mRange.lower;
- else
- return -(value-mAxisRect->left())/(double)mAxisRect->width()*mRange.size()+mRange.upper;
- } else // mScaleType == stLogarithmic
- {
- if (!mRangeReversed)
- return pow(mRange.upper/mRange.lower, (value-mAxisRect->left())/(double)mAxisRect->width())*mRange.lower;
- else
- return pow(mRange.upper/mRange.lower, (mAxisRect->left()-value)/(double)mAxisRect->width())*mRange.upper;
- }
- } else // orientation() == Qt::Vertical
- {
- if (mScaleType == stLinear)
- {
- if (!mRangeReversed)
- return (mAxisRect->bottom()-value)/(double)mAxisRect->height()*mRange.size()+mRange.lower;
- else
- return -(mAxisRect->bottom()-value)/(double)mAxisRect->height()*mRange.size()+mRange.upper;
- } else // mScaleType == stLogarithmic
- {
- if (!mRangeReversed)
- return pow(mRange.upper/mRange.lower, (mAxisRect->bottom()-value)/(double)mAxisRect->height())*mRange.lower;
- else
- return pow(mRange.upper/mRange.lower, (value-mAxisRect->bottom())/(double)mAxisRect->height())*mRange.upper;
- }
- }
- }
-
- /*!
- Transforms \a value, in coordinates of the axis, to pixel coordinates of the QCustomPlot widget.
- */
- double QCPAxis::coordToPixel(double value) const
- {
- if (orientation() == Qt::Horizontal)
- {
- if (mScaleType == stLinear)
- {
- if (!mRangeReversed)
- return (value-mRange.lower)/mRange.size()*mAxisRect->width()+mAxisRect->left();
- else
- return (mRange.upper-value)/mRange.size()*mAxisRect->width()+mAxisRect->left();
- } else // mScaleType == stLogarithmic
- {
- if (value >= 0 && mRange.upper < 0) // invalid value for logarithmic scale, just draw it outside visible range
- return !mRangeReversed ? mAxisRect->right()+200 : mAxisRect->left()-200;
- else if (value <= 0 && mRange.upper > 0) // invalid value for logarithmic scale, just draw it outside visible range
- return !mRangeReversed ? mAxisRect->left()-200 : mAxisRect->right()+200;
- else
- {
- if (!mRangeReversed)
- return baseLog(value/mRange.lower)/baseLog(mRange.upper/mRange.lower)*mAxisRect->width()+mAxisRect->left();
- else
- return baseLog(mRange.upper/value)/baseLog(mRange.upper/mRange.lower)*mAxisRect->width()+mAxisRect->left();
- }
- }
- } else // orientation() == Qt::Vertical
- {
- if (mScaleType == stLinear)
- {
- if (!mRangeReversed)
- return mAxisRect->bottom()-(value-mRange.lower)/mRange.size()*mAxisRect->height();
- else
- return mAxisRect->bottom()-(mRange.upper-value)/mRange.size()*mAxisRect->height();
- } else // mScaleType == stLogarithmic
- {
- if (value >= 0 && mRange.upper < 0) // invalid value for logarithmic scale, just draw it outside visible range
- return !mRangeReversed ? mAxisRect->top()-200 : mAxisRect->bottom()+200;
- else if (value <= 0 && mRange.upper > 0) // invalid value for logarithmic scale, just draw it outside visible range
- return !mRangeReversed ? mAxisRect->bottom()+200 : mAxisRect->top()-200;
- else
- {
- if (!mRangeReversed)
- return mAxisRect->bottom()-baseLog(value/mRange.lower)/baseLog(mRange.upper/mRange.lower)*mAxisRect->height();
- else
- return mAxisRect->bottom()-baseLog(mRange.upper/value)/baseLog(mRange.upper/mRange.lower)*mAxisRect->height();
- }
- }
- }
- }
-
- /*!
- Returns the part of the axis that is hit by \a pos (in pixels). The return value of this function
- is independent of the user-selectable parts defined with \ref setSelectableParts. Further, this
- function does not change the current selection state of the axis.
-
- If the axis is not visible (\ref setVisible), this function always returns \ref spNone.
-
- \see setSelectedParts, setSelectableParts, QCustomPlot::setInteractions
- */
- QCPAxis::SelectablePart QCPAxis::getPartAt(const QPointF &pos) const
- {
- if (!mVisible)
- return spNone;
-
- if (mAxisSelectionBox.contains(pos.toPoint()))
- return spAxis;
- else if (mTickLabelsSelectionBox.contains(pos.toPoint()))
- return spTickLabels;
- else if (mLabelSelectionBox.contains(pos.toPoint()))
- return spAxisLabel;
- else
- return spNone;
- }
-
- /* inherits documentation from base class */
- double QCPAxis::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const
- {
- if (!mParentPlot) return -1;
- SelectablePart part = getPartAt(pos);
- if ((onlySelectable && !mSelectableParts.testFlag(part)) || part == spNone)
- return -1;
-
- if (details)
- details->setValue(part);
- return mParentPlot->selectionTolerance()*0.99;
- }
-
- /*!
- Returns a list of all the plottables that have this axis as key or value axis.
-
- If you are only interested in plottables of type QCPGraph, see \ref graphs.
-
- \see graphs, items
- */
- QList<QCPAbstractPlottable*> QCPAxis::plottables() const
- {
- QList<QCPAbstractPlottable*> result;
- if (!mParentPlot) return result;
-
- for (int i=0; i<mParentPlot->mPlottables.size(); ++i)
- {
- if (mParentPlot->mPlottables.at(i)->keyAxis() == this ||mParentPlot->mPlottables.at(i)->valueAxis() == this)
- result.append(mParentPlot->mPlottables.at(i));
- }
- return result;
- }
-
- /*!
- Returns a list of all the graphs that have this axis as key or value axis.
-
- \see plottables, items
- */
- QList<QCPGraph*> QCPAxis::graphs() const
- {
- QList<QCPGraph*> result;
- if (!mParentPlot) return result;
-
- for (int i=0; i<mParentPlot->mGraphs.size(); ++i)
- {
- if (mParentPlot->mGraphs.at(i)->keyAxis() == this || mParentPlot->mGraphs.at(i)->valueAxis() == this)
- result.append(mParentPlot->mGraphs.at(i));
- }
- return result;
- }
-
- /*!
- Returns a list of all the items that are associated with this axis. An item is considered
- associated with an axis if at least one of its positions uses the axis as key or value axis.
-
- \see plottables, graphs
- */
- QList<QCPAbstractItem*> QCPAxis::items() const
- {
- QList<QCPAbstractItem*> result;
- if (!mParentPlot) return result;
-
- for (int itemId=0; itemId<mParentPlot->mItems.size(); ++itemId)
- {
- QList<QCPItemPosition*> positions = mParentPlot->mItems.at(itemId)->positions();
- for (int posId=0; posId<positions.size(); ++posId)
- {
- if (positions.at(posId)->keyAxis() == this || positions.at(posId)->valueAxis() == this)
- {
- result.append(mParentPlot->mItems.at(itemId));
- break;
- }
- }
- }
- return result;
- }
-
- /*!
- Transforms a margin side to the logically corresponding axis type. (QCP::msLeft to
- QCPAxis::atLeft, QCP::msRight to QCPAxis::atRight, etc.)
- */
- QCPAxis::AxisType QCPAxis::marginSideToAxisType(QCP::MarginSide side)
- {
- switch (side)
- {
- case QCP::msLeft: return atLeft;
- case QCP::msRight: return atRight;
- case QCP::msTop: return atTop;
- case QCP::msBottom: return atBottom;
- default: break;
- }
- qDebug() << Q_FUNC_INFO << "Invalid margin side passed:" << (int)side;
- return atLeft;
- }
-
- /*! \internal
-
- This function is called to prepare the tick vector, sub tick vector and tick label vector. If
- \ref setAutoTicks is set to true, appropriate tick values are determined automatically via \ref
- generateAutoTicks. If it's set to false, the signal ticksRequest is emitted, which can be used to
- provide external tick positions. Then the sub tick vectors and tick label vectors are created.
- */
- void QCPAxis::setupTickVectors()
- {
- if (!mParentPlot) return;
- if ((!mTicks && !mTickLabels && !mGrid->visible()) || mRange.size() <= 0) return;
-
- // fill tick vectors, either by auto generating or by notifying user to fill the vectors himself
- if (mAutoTicks)
- {
- generateAutoTicks();
- } else
- {
- emit ticksRequest();
- }
-
- visibleTickBounds(mLowestVisibleTick, mHighestVisibleTick);
- if (mTickVector.isEmpty())
- {
- mSubTickVector.clear();
- return;
- }
-
- // generate subticks between ticks:
- mSubTickVector.resize((mTickVector.size()-1)*mSubTickCount);
- if (mSubTickCount > 0)
- {
- double subTickStep = 0;
- double subTickPosition = 0;
- int subTickIndex = 0;
- bool done = false;
- int lowTick = mLowestVisibleTick > 0 ? mLowestVisibleTick-1 : mLowestVisibleTick;
- int highTick = mHighestVisibleTick < mTickVector.size()-1 ? mHighestVisibleTick+1 : mHighestVisibleTick;
- for (int i=lowTick+1; i<=highTick; ++i)
- {
- subTickStep = (mTickVector.at(i)-mTickVector.at(i-1))/(double)(mSubTickCount+1);
- for (int k=1; k<=mSubTickCount; ++k)
- {
- subTickPosition = mTickVector.at(i-1) + k*subTickStep;
- if (subTickPosition < mRange.lower)
- continue;
- if (subTickPosition > mRange.upper)
- {
- done = true;
- break;
- }
- mSubTickVector[subTickIndex] = subTickPosition;
- subTickIndex++;
- }
- if (done) break;
- }
- mSubTickVector.resize(subTickIndex);
- }
-
- // generate tick labels according to tick positions:
- mExponentialChar = mParentPlot->locale().exponential(); // will be needed when drawing the numbers generated here, in getTickLabelData()
- mPositiveSignChar = mParentPlot->locale().positiveSign(); // will be needed when drawing the numbers generated here, in getTickLabelData()
- if (mAutoTickLabels)
- {
- int vecsize = mTickVector.size();
- mTickVectorLabels.resize(vecsize);
- if (mTickLabelType == ltNumber)
- {
- for (int i=mLowestVisibleTick; i<=mHighestVisibleTick; ++i)
- mTickVectorLabels[i] = mParentPlot->locale().toString(mTickVector.at(i), mNumberFormatChar, mNumberPrecision);
- } else if (mTickLabelType == ltDateTime)
- {
- for (int i=mLowestVisibleTick; i<=mHighestVisibleTick; ++i)
- {
- #if QT_VERSION < QT_VERSION_CHECK(4, 7, 0) // use fromMSecsSinceEpoch function if available, to gain sub-second accuracy on tick labels (e.g. for format "hh:mm:ss:zzz")
- mTickVectorLabels[i] = mParentPlot->locale().toString(QDateTime::fromTime_t(mTickVector.at(i)).toTimeSpec(mDateTimeSpec), mDateTimeFormat);
- #else
- mTickVectorLabels[i] = mParentPlot->locale().toString(QDateTime::fromMSecsSinceEpoch(mTickVector.at(i)*1000).toTimeSpec(mDateTimeSpec), mDateTimeFormat);
- #endif
- }
- }
- } else // mAutoTickLabels == false
- {
- if (mAutoTicks) // ticks generated automatically, but not ticklabels, so emit ticksRequest here for labels
- {
- emit ticksRequest();
- }
- // make sure provided tick label vector has correct (minimal) length:
- if (mTickVectorLabels.size() < mTickVector.size())
- mTickVectorLabels.resize(mTickVector.size());
- }
- }
-
- /*! \internal
-
- If \ref setAutoTicks is set to true, this function is called by \ref setupTickVectors to
- generate reasonable tick positions (and subtick count). The algorithm tries to create
- approximately <tt>mAutoTickCount</tt> ticks (set via \ref setAutoTickCount).
-
- If the scale is logarithmic, \ref setAutoTickCount is ignored, and one tick is generated at every
- power of the current logarithm base, set via \ref setScaleLogBase.
- */
- void QCPAxis::generateAutoTicks()
- {
- if (mScaleType == stLinear)
- {
- if (mAutoTickStep)
- {
- // Generate tick positions according to linear scaling:
- mTickStep = mRange.size()/(double)(mAutoTickCount+1e-10); // mAutoTickCount ticks on average, the small addition is to prevent jitter on exact integers
- double magnitudeFactor = qPow(10.0, qFloor(qLn(mTickStep)/qLn(10.0))); // get magnitude factor e.g. 0.01, 1, 10, 1000 etc.
- double tickStepMantissa = mTickStep/magnitudeFactor;
- if (tickStepMantissa < 5)
- {
- // round digit after decimal point to 0.5
- mTickStep = (int)(tickStepMantissa*2)/2.0*magnitudeFactor;
- } else
- {
- // round to first digit in multiples of 2
- mTickStep = (int)(tickStepMantissa/2.0)*2.0*magnitudeFactor;
- }
- }
- if (mAutoSubTicks)
- mSubTickCount = calculateAutoSubTickCount(mTickStep);
- // Generate tick positions according to mTickStep:
- qint64 firstStep = floor(mRange.lower/mTickStep);
- qint64 lastStep = ceil(mRange.upper/mTickStep);
- int tickcount = lastStep-firstStep+1;
- if (tickcount < 0) tickcount = 0;
- mTickVector.resize(tickcount);
- for (int i=0; i<tickcount; ++i)
- mTickVector[i] = (firstStep+i)*mTickStep;
- } else // mScaleType == stLogarithmic
- {
- // Generate tick positions according to logbase scaling:
- if (mRange.lower > 0 && mRange.upper > 0) // positive range
- {
- double lowerMag = basePow((int)floor(baseLog(mRange.lower)));
- double currentMag = lowerMag;
- mTickVector.clear();
- mTickVector.append(currentMag);
- while (currentMag < mRange.upper && currentMag > 0) // currentMag might be zero for ranges ~1e-300, just cancel in that case
- {
- currentMag *= mScaleLogBase;
- mTickVector.append(currentMag);
- }
- } else if (mRange.lower < 0 && mRange.upper < 0) // negative range
- {
- double lowerMag = -basePow((int)ceil(baseLog(-mRange.lower)));
- double currentMag = lowerMag;
- mTickVector.clear();
- mTickVector.append(currentMag);
- while (currentMag < mRange.upper && currentMag < 0) // currentMag might be zero for ranges ~1e-300, just cancel in that case
- {
- currentMag /= mScaleLogBase;
- mTickVector.append(currentMag);
- }
- } else // invalid range for logarithmic scale, because lower and upper have different sign
- {
- mTickVector.clear();
- qDebug() << Q_FUNC_INFO << "Invalid range for logarithmic plot: " << mRange.lower << "-" << mRange.upper;
- }
- }
- }
-
- /*! \internal
-
- Called by generateAutoTicks when \ref setAutoSubTicks is set to true. Depending on the \a
- tickStep between two major ticks on the axis, a different number of sub ticks is appropriate. For
- Example taking 4 sub ticks for a \a tickStep of 1 makes more sense than taking 5 sub ticks,
- because this corresponds to a sub tick step of 0.2, instead of the less intuitive 0.16667. Note
- that a subtick count of 4 means dividing the major tick step into 5 sections.
-
- This is implemented by a hand made lookup for integer tick steps as well as fractional tick steps
- with a fractional part of (approximately) 0.5. If a tick step is different (i.e. has no
- fractional part close to 0.5), the currently set sub tick count (\ref setSubTickCount) is
- returned.
- */
- int QCPAxis::calculateAutoSubTickCount(double tickStep) const
- {
- int result = mSubTickCount; // default to current setting, if no proper value can be found
-
- // get mantissa of tickstep:
- double magnitudeFactor = qPow(10.0, qFloor(qLn(tickStep)/qLn(10.0))); // get magnitude factor e.g. 0.01, 1, 10, 1000 etc.
- double tickStepMantissa = tickStep/magnitudeFactor;
-
- // separate integer and fractional part of mantissa:
- double epsilon = 0.01;
- double intPartf;
- int intPart;
- double fracPart = modf(tickStepMantissa, &intPartf);
- intPart = intPartf;
-
- // handle cases with (almost) integer mantissa:
- if (fracPart < epsilon || 1.0-fracPart < epsilon)
- {
- if (1.0-fracPart < epsilon)
- ++intPart;
- switch (intPart)
- {
- case 1: result = 4; break; // 1.0 -> 0.2 substep
- case 2: result = 3; break; // 2.0 -> 0.5 substep
- case 3: result = 2; break; // 3.0 -> 1.0 substep
- case 4: result = 3; break; // 4.0 -> 1.0 substep
- case 5: result = 4; break; // 5.0 -> 1.0 substep
- case 6: result = 2; break; // 6.0 -> 2.0 substep
- case 7: result = 6; break; // 7.0 -> 1.0 substep
- case 8: result = 3; break; // 8.0 -> 2.0 substep
- case 9: result = 2; break; // 9.0 -> 3.0 substep
- }
- } else
- {
- // handle cases with significantly fractional mantissa:
- if (qAbs(fracPart-0.5) < epsilon) // *.5 mantissa
- {
- switch (intPart)
- {
- case 1: result = 2; break; // 1.5 -> 0.5 substep
- case 2: result = 4; break; // 2.5 -> 0.5 substep
- case 3: result = 4; break; // 3.5 -> 0.7 substep
- case 4: result = 2; break; // 4.5 -> 1.5 substep
- case 5: result = 4; break; // 5.5 -> 1.1 substep (won't occur with autoTickStep from here on)
- case 6: result = 4; break; // 6.5 -> 1.3 substep
- case 7: result = 2; break; // 7.5 -> 2.5 substep
- case 8: result = 4; break; // 8.5 -> 1.7 substep
- case 9: result = 4; break; // 9.5 -> 1.9 substep
- }
- }
- // if mantissa fraction isnt 0.0 or 0.5, don't bother finding good sub tick marks, leave default
- }
-
- return result;
- }
-
- /*! \internal
-
- Draws the axis with the specified \a painter.
-
- The selection boxes (mAxisSelectionBox, mTickLabelsSelectionBox, mLabelSelectionBox) are set
- here, too.
- */
- void QCPAxis::draw(QCPPainter *painter)
- {
- if (!mParentPlot) return;
- QPoint origin;
- if (mAxisType == atLeft)
- origin = mAxisRect->bottomLeft()+QPoint(-mOffset, 0);
- else if (mAxisType == atRight)
- origin = mAxisRect->bottomRight()+QPoint(+mOffset, 0);
- else if (mAxisType == atTop)
- origin = mAxisRect->topLeft()+QPoint(0, -mOffset);
- else if (mAxisType == atBottom)
- origin = mAxisRect->bottomLeft()+QPoint(0, +mOffset);
-
- double xCor = 0, yCor = 0; // paint system correction, for pixel exact matches (affects baselines and ticks of top/right axes)
- switch (mAxisType)
- {
- case atTop: yCor = -1; break;
- case atRight: xCor = 1; break;
- default: break;
- }
-
- int margin = 0;
- int lowTick = mLowestVisibleTick;
- int highTick = mHighestVisibleTick;
- double t; // helper variable, result of coordinate-to-pixel transforms
-
- // draw baseline:
- QLineF baseLine;
- painter->setPen(getBasePen());
- if (orientation() == Qt::Horizontal)
- baseLine.setPoints(origin+QPointF(xCor, yCor), origin+QPointF(mAxisRect->width()+xCor, yCor));
- else
- baseLine.setPoints(origin+QPointF(xCor, yCor), origin+QPointF(xCor, -mAxisRect->height()+yCor));
- if (mRangeReversed)
- baseLine = QLineF(baseLine.p2(), baseLine.p1()); // won't make a difference for line itself, but for line endings later
- painter->drawLine(baseLine);
-
- // draw ticks:
- if (mTicks)
- {
- painter->setPen(getTickPen());
- // direction of ticks ("inward" is right for left axis and left for right axis)
- int tickDir = (mAxisType == atBottom || mAxisType == atRight) ? -1 : 1;
- if (orientation() == Qt::Horizontal)
- {
- for (int i=lowTick; i <= highTick; ++i)
- {
- t = coordToPixel(mTickVector.at(i)); // x
- painter->drawLine(QLineF(t+xCor, origin.y()-mTickLengthOut*tickDir+yCor, t+xCor, origin.y()+mTickLengthIn*tickDir+yCor));
- }
- } else
- {
- for (int i=lowTick; i <= highTick; ++i)
- {
- t = coordToPixel(mTickVector.at(i)); // y
- painter->drawLine(QLineF(origin.x()-mTickLengthOut*tickDir+xCor, t+yCor, origin.x()+mTickLengthIn*tickDir+xCor, t+yCor));
- }
- }
- }
-
- // draw subticks:
- if (mTicks && mSubTickCount > 0)
- {
- painter->setPen(getSubTickPen());
- // direction of ticks ("inward" is right for left axis and left for right axis)
- int tickDir = (mAxisType == atBottom || mAxisType == atRight) ? -1 : 1;
- if (orientation() == Qt::Horizontal)
- {
- for (int i=0; i<mSubTickVector.size(); ++i) // no need to check bounds because subticks are always only created inside current mRange
- {
- t = coordToPixel(mSubTickVector.at(i));
- painter->drawLine(QLineF(t+xCor, origin.y()-mSubTickLengthOut*tickDir+yCor, t+xCor, origin.y()+mSubTickLengthIn*tickDir+yCor));
- }
- } else
- {
- for (int i=0; i<mSubTickVector.size(); ++i)
- {
- t = coordToPixel(mSubTickVector.at(i));
- painter->drawLine(QLineF(origin.x()-mSubTickLengthOut*tickDir+xCor, t+yCor, origin.x()+mSubTickLengthIn*tickDir+xCor, t+yCor));
- }
- }
- }
- margin += qMax(0, qMax(mTickLengthOut, mSubTickLengthOut));
-
- // draw axis base endings:
- bool antialiasingBackup = painter->antialiasing();
- painter->setAntialiasing(true); // always want endings to be antialiased, even if base and ticks themselves aren't
- painter->setBrush(QBrush(basePen().color()));
- QVector2D baseLineVector(baseLine.dx(), baseLine.dy());
- if (mLowerEnding.style() != QCPLineEnding::esNone)
- mLowerEnding.draw(painter, QVector2D(baseLine.p1())-baseLineVector.normalized()*mLowerEnding.realLength()*(mLowerEnding.inverted()?-1:1), -baseLineVector);
- if (mUpperEnding.style() != QCPLineEnding::esNone)
- mUpperEnding.draw(painter, QVector2D(baseLine.p2())+baseLineVector.normalized()*mUpperEnding.realLength()*(mUpperEnding.inverted()?-1:1), baseLineVector);
- painter->setAntialiasing(antialiasingBackup);
-
- // tick labels:
- QSize tickLabelsSize(0, 0); // size of largest tick label, for offset calculation of axis label
- if (mTickLabels)
- {
- margin += mTickLabelPadding;
- painter->setFont(getTickLabelFont());
- painter->setPen(QPen(getTickLabelColor()));
- for (int i=lowTick; i <= highTick; ++i)
- {
- t = coordToPixel(mTickVector.at(i));
- placeTickLabel(painter, t, margin, mTickVectorLabels.at(i), &tickLabelsSize);
- }
- }
- if (orientation() == Qt::Horizontal)
- margin += tickLabelsSize.height();
- else
- margin += tickLabelsSize.width();
-
- // axis label:
- QRect labelBounds;
- if (!mLabel.isEmpty())
- {
- margin += mLabelPadding;
- painter->setFont(getLabelFont());
- painter->setPen(QPen(getLabelColor()));
- labelBounds = painter->fontMetrics().boundingRect(0, 0, 0, 0, Qt::TextDontClip, mLabel);
- if (mAxisType == atLeft)
- {
- QTransform oldTransform = painter->transform();
- painter->translate((origin.x()-margin-labelBounds.height()), origin.y());
- painter->rotate(-90);
- painter->drawText(0, 0, mAxisRect->height(), labelBounds.height(), Qt::TextDontClip | Qt::AlignCenter, mLabel);
- painter->setTransform(oldTransform);
- }
- else if (mAxisType == atRight)
- {
- QTransform oldTransform = painter->transform();
- painter->translate((origin.x()+margin+labelBounds.height()), origin.y()-mAxisRect->height());
- painter->rotate(90);
- painter->drawText(0, 0, mAxisRect->height(), labelBounds.height(), Qt::TextDontClip | Qt::AlignCenter, mLabel);
- painter->setTransform(oldTransform);
- }
- else if (mAxisType == atTop)
- painter->drawText(origin.x(), origin.y()-margin-labelBounds.height(), mAxisRect->width(), labelBounds.height(), Qt::TextDontClip | Qt::AlignCenter, mLabel);
- else if (mAxisType == atBottom)
- painter->drawText(origin.x(), origin.y()+margin, mAxisRect->width(), labelBounds.height(), Qt::TextDontClip | Qt::AlignCenter, mLabel);
- }
-
- // set selection boxes:
- int selAxisOutSize = qMax(qMax(mTickLengthOut, mSubTickLengthOut), mParentPlot->selectionTolerance());
- int selAxisInSize = mParentPlot->selectionTolerance();
- int selTickLabelSize = (orientation()==Qt::Horizontal ? tickLabelsSize.height() : tickLabelsSize.width());
- int selTickLabelOffset = qMax(mTickLengthOut, mSubTickLengthOut)+mTickLabelPadding;
- int selLabelSize = labelBounds.height();
- int selLabelOffset = selTickLabelOffset+selTickLabelSize+mLabelPadding;
- if (mAxisType == atLeft)
- {
- mAxisSelectionBox.setCoords(origin.x()-selAxisOutSize, mAxisRect->top(), origin.x()+selAxisInSize, mAxisRect->bottom());
- mTickLabelsSelectionBox.setCoords(origin.x()-selTickLabelOffset-selTickLabelSize, mAxisRect->top(), origin.x()-selTickLabelOffset, mAxisRect->bottom());
- mLabelSelectionBox.setCoords(origin.x()-selLabelOffset-selLabelSize, mAxisRect->top(), origin.x()-selLabelOffset, mAxisRect->bottom());
- } else if (mAxisType == atRight)
- {
- mAxisSelectionBox.setCoords(origin.x()-selAxisInSize, mAxisRect->top(), origin.x()+selAxisOutSize, mAxisRect->bottom());
- mTickLabelsSelectionBox.setCoords(origin.x()+selTickLabelOffset+selTickLabelSize, mAxisRect->top(), origin.x()+selTickLabelOffset, mAxisRect->bottom());
- mLabelSelectionBox.setCoords(origin.x()+selLabelOffset+selLabelSize, mAxisRect->top(), origin.x()+selLabelOffset, mAxisRect->bottom());
- } else if (mAxisType == atTop)
- {
- mAxisSelectionBox.setCoords(mAxisRect->left(), origin.y()-selAxisOutSize, mAxisRect->right(), origin.y()+selAxisInSize);
- mTickLabelsSelectionBox.setCoords(mAxisRect->left(), origin.y()-selTickLabelOffset-selTickLabelSize, mAxisRect->right(), origin.y()-selTickLabelOffset);
- mLabelSelectionBox.setCoords(mAxisRect->left(), origin.y()-selLabelOffset-selLabelSize, mAxisRect->right(), origin.y()-selLabelOffset);
- } else if (mAxisType == atBottom)
- {
- mAxisSelectionBox.setCoords(mAxisRect->left(), origin.y()-selAxisInSize, mAxisRect->right(), origin.y()+selAxisOutSize);
- mTickLabelsSelectionBox.setCoords(mAxisRect->left(), origin.y()+selTickLabelOffset+selTickLabelSize, mAxisRect->right(), origin.y()+selTickLabelOffset);
- mLabelSelectionBox.setCoords(mAxisRect->left(), origin.y()+selLabelOffset+selLabelSize, mAxisRect->right(), origin.y()+selLabelOffset);
- }
- // draw hitboxes for debug purposes:
- //painter->setBrush(Qt::NoBrush);
- //painter->drawRects(QVector<QRect>() << mAxisSelectionBox << mTickLabelsSelectionBox << mLabelSelectionBox);
- }
-
- /*! \internal
-
- Draws a single tick label with the provided \a painter, utilizing the internal label cache to
- significantly speed up drawing of labels that were drawn in previous calls. The tick label is
- always bound to an axis, the distance to the axis is controllable via \a distanceToAxis in
- pixels. The pixel position in the axis direction is passed in the \a position parameter. Hence
- for the bottom axis, \a position would indicate the horizontal pixel position (not coordinate),
- at which the label should be drawn.
-
- In order to later draw the axis label in a place that doesn't overlap with the tick labels, the
- largest tick label size is needed. This is acquired by passing a \a tickLabelsSize to the \ref
- drawTickLabel calls during the process of drawing all tick labels of one axis. In every call, \a
- tickLabelsSize is expanded, if the drawn label exceeds the value \a tickLabelsSize currently
- holds.
-
- The label is drawn with the font and pen that are currently set on the \a painter. To draw
- superscripted powers, the font is temporarily made smaller by a fixed factor (see \ref
- getTickLabelData).
- */
- void QCPAxis::placeTickLabel(QCPPainter *painter, double position, int distanceToAxis, const QString &text, QSize *tickLabelsSize)
- {
- // warning: if you change anything here, also adapt getMaxTickLabelSize() accordingly!
- if (!mParentPlot) return;
- if (text.isEmpty()) return;
- QSize finalSize;
- QPointF labelAnchor;
- switch (mAxisType)
- {
- case atLeft: labelAnchor = QPointF(mAxisRect->left()-distanceToAxis-mOffset, position); break;
- case atRight: labelAnchor = QPointF(mAxisRect->right()+distanceToAxis+mOffset, position); break;
- case atTop: labelAnchor = QPointF(position, mAxisRect->top()-distanceToAxis-mOffset); break;
- case atBottom: labelAnchor = QPointF(position, mAxisRect->bottom()+distanceToAxis+mOffset); break;
- }
- if (parentPlot()->plottingHints().testFlag(QCP::phCacheLabels) && !painter->modes().testFlag(QCPPainter::pmNoCaching)) // label caching enabled
- {
- if (!mLabelCache.contains(text)) // no cached label exists, create it
- {
- CachedLabel *newCachedLabel = new CachedLabel;
- TickLabelData labelData = getTickLabelData(painter->font(), text);
- QPointF drawOffset = getTickLabelDrawOffset(labelData);
- newCachedLabel->offset = drawOffset+labelData.rotatedTotalBounds.topLeft();
- newCachedLabel->pixmap = QPixmap(labelData.rotatedTotalBounds.size());
- newCachedLabel->pixmap.fill(Qt::transparent);
- QCPPainter cachePainter(&newCachedLabel->pixmap);
- cachePainter.setPen(painter->pen());
- drawTickLabel(&cachePainter, -labelData.rotatedTotalBounds.topLeft().x(), -labelData.rotatedTotalBounds.topLeft().y(), labelData);
- mLabelCache.insert(text, newCachedLabel, 1);
- }
- // draw cached label:
- const CachedLabel *cachedLabel = mLabelCache.object(text);
- // if label would be partly clipped by widget border on sides, don't draw it:
- if (orientation() == Qt::Horizontal)
- {
- if (labelAnchor.x()+cachedLabel->offset.x()+cachedLabel->pixmap.width() > mParentPlot->viewport().right() ||
- labelAnchor.x()+cachedLabel->offset.x() < mParentPlot->viewport().left())
- return;
- } else
- {
- if (labelAnchor.y()+cachedLabel->offset.y()+cachedLabel->pixmap.height() > mParentPlot->viewport().bottom() ||
- labelAnchor.y()+cachedLabel->offset.y() < mParentPlot->viewport().top())
- return;
- }
- painter->drawPixmap(labelAnchor+cachedLabel->offset, cachedLabel->pixmap);
- finalSize = cachedLabel->pixmap.size();
- } else // label caching disabled, draw text directly on surface:
- {
- TickLabelData labelData = getTickLabelData(painter->font(), text);
- QPointF finalPosition = labelAnchor + getTickLabelDrawOffset(labelData);
- // if label would be partly clipped by widget border on sides, don't draw it:
- if (orientation() == Qt::Horizontal)
- {
- if (finalPosition.x()+(labelData.rotatedTotalBounds.width()+labelData.rotatedTotalBounds.left()) > mParentPlot->viewport().right() ||
- finalPosition.x()+labelData.rotatedTotalBounds.left() < mParentPlot->viewport().left())
- return;
- } else
- {
- if (finalPosition.y()+(labelData.rotatedTotalBounds.height()+labelData.rotatedTotalBounds.top()) > mParentPlot->viewport().bottom() ||
- finalPosition.y()+labelData.rotatedTotalBounds.top() < mParentPlot->viewport().top())
- return;
- }
- drawTickLabel(painter, finalPosition.x(), finalPosition.y(), labelData);
- finalSize = labelData.rotatedTotalBounds.size();
- }
-
- // expand passed tickLabelsSize if current tick label is larger:
- if (finalSize.width() > tickLabelsSize->width())
- tickLabelsSize->setWidth(finalSize.width());
- if (finalSize.height() > tickLabelsSize->height())
- tickLabelsSize->setHeight(finalSize.height());
- }
-
- /*! \internal
-
- This is a \ref placeTickLabel helper function.
-
- Draws the tick label specified in \a labelData with \a painter at the pixel positions \a x and \a
- y. This function is used by \ref placeTickLabel to create new tick labels for the cache, or to
- directly draw the labels on the QCustomPlot surface when label caching is disabled, i.e. when
- QCP::phCacheLabels plotting hint is not set.
- */
- void QCPAxis::drawTickLabel(QCPPainter *painter, double x, double y, const QCPAxis::TickLabelData &labelData) const
- {
- // backup painter settings that we're about to change:
- QTransform oldTransform = painter->transform();
- QFont oldFont = painter->font();
-
- // transform painter to position/rotation:
- painter->translate(x, y);
- if (!qFuzzyIsNull(mTickLabelRotation))
- painter->rotate(mTickLabelRotation);
-
- // draw text:
- if (!labelData.expPart.isEmpty()) // indicator that beautiful powers must be used
- {
- painter->setFont(labelData.baseFont);
- painter->drawText(0, 0, 0, 0, Qt::TextDontClip, labelData.basePart);
- painter->setFont(labelData.expFont);
- painter->drawText(labelData.baseBounds.width()+1, 0, labelData.expBounds.width(), labelData.expBounds.height(), Qt::TextDontClip, labelData.expPart);
- } else
- {
- painter->setFont(labelData.baseFont);
- painter->drawText(0, 0, labelData.totalBounds.width(), labelData.totalBounds.height(), Qt::TextDontClip | Qt::AlignHCenter, labelData.basePart);
- }
-
- // reset painter settings to what it was before:
- painter->setTransform(oldTransform);
- painter->setFont(oldFont);
- }
-
- /*! \internal
-
- This is a \ref placeTickLabel helper function.
-
- Transforms the passed \a text and \a font to a tickLabelData structure that can then be further
- processed by \ref getTickLabelDrawOffset and \ref drawTickLabel. It splits the text into base and
- exponent if necessary (see \ref setNumberFormat) and calculates appropriate bounding boxes.
- */
- QCPAxis::TickLabelData QCPAxis::getTickLabelData(const QFont &font, const QString &text) const
- {
- TickLabelData result;
-
- // determine whether beautiful decimal powers should be used
- bool useBeautifulPowers = false;
- int ePos = -1;
- if (mAutoTickLabels && mNumberBeautifulPowers && mTickLabelType == ltNumber)
- {
- ePos = text.indexOf('e');
- if (ePos > -1)
- useBeautifulPowers = true;
- }
-
- // calculate text bounding rects and do string preparation for beautiful decimal powers:
- result.baseFont = font;
- result.baseFont.setPointSizeF(result.baseFont.pointSizeF()+0.05); // QFontMetrics.boundingRect has a bug for exact point sizes that make the results oscillate due to internal rounding
- if (useBeautifulPowers)
- {
- // split text into parts of number/symbol that will be drawn normally and part that will be drawn as exponent:
- result.basePart = text.left(ePos);
- // in log scaling, we want to turn "1*10^n" into "10^n", else add multiplication sign and decimal base:
- if (mScaleType == stLogarithmic && result.basePart == "1")
- result.basePart = "10";
- else
- result.basePart += (mNumberMultiplyCross ? QString(QChar(215)) : QString(QChar(183))) + "10";
- result.expPart = text.mid(ePos+1);
- // clip "+" and leading zeros off expPart:
- while (result.expPart.at(1) == '0' && result.expPart.length() > 2) // length > 2 so we leave one zero when numberFormatChar is 'e'
- result.expPart.remove(1, 1);
- if (result.expPart.at(0) == mPositiveSignChar)
- result.expPart.remove(0, 1);
- // prepare smaller font for exponent:
- result.expFont = font;
- result.expFont.setPointSize(result.expFont.pointSize()*0.75);
- // calculate bounding rects of base part, exponent part and total one:
- result.baseBounds = QFontMetrics(result.baseFont).boundingRect(0, 0, 0, 0, Qt::TextDontClip, result.basePart);
- result.expBounds = QFontMetrics(result.expFont).boundingRect(0, 0, 0, 0, Qt::TextDontClip, result.expPart);
- result.totalBounds = result.baseBounds.adjusted(0, 0, result.expBounds.width()+2, 0); // +2 consists of the 1 pixel spacing between base and exponent (see drawTickLabel) and an extra pixel to include AA
- } else // useBeautifulPowers == false
- {
- result.basePart = text;
- result.totalBounds = QFontMetrics(result.baseFont).boundingRect(0, 0, 0, 0, Qt::TextDontClip | Qt::AlignHCenter, result.basePart);
- }
- result.totalBounds.moveTopLeft(QPoint(0, 0)); // want bounding box aligned top left at origin, independent of how it was created, to make further processing simpler
-
- // calculate possibly different bounding rect after rotation:
- result.rotatedTotalBounds = result.totalBounds;
- if (!qFuzzyIsNull(mTickLabelRotation))
- {
- QTransform transform;
- transform.rotate(mTickLabelRotation);
- result.rotatedTotalBounds = transform.mapRect(result.rotatedTotalBounds);
- }
-
- return result;
- }
-
- /*! \internal
-
- This is a \ref placeTickLabel helper function.
-
- Calculates the offset at which the top left corner of the specified tick label shall be drawn.
- The offset is relative to a point right next to the tick the label belongs to.
-
- This function is thus responsible for e.g. centering tick labels under ticks and positioning them
- appropriately when they are rotated.
- */
- QPointF QCPAxis::getTickLabelDrawOffset(const QCPAxis::TickLabelData &labelData) const
- {
- /*
- calculate label offset from base point at tick (non-trivial, for best visual appearance): short
- explanation for bottom axis: The anchor, i.e. the point in the label that is placed
- horizontally under the corresponding tick is always on the label side that is closer to the
- axis (e.g. the left side of the text when we're rotating clockwise). On that side, the height
- is halved and the resulting point is defined the anchor. This way, a 90 degree rotated text
- will be centered under the tick (i.e. displaced horizontally by half its height). At the same
- time, a 45 degree rotated text will "point toward" its tick, as is typical for rotated tick
- labels.
- */
- bool doRotation = !qFuzzyIsNull(mTickLabelRotation);
- bool flip = qFuzzyCompare(qAbs(mTickLabelRotation), 90.0); // perfect +/-90 degree flip. Indicates vertical label centering on vertical axes.
- double radians = mTickLabelRotation/180.0*M_PI;
- int x=0, y=0;
- if (mAxisType == atLeft)
- {
- if (doRotation)
- {
- if (mTickLabelRotation > 0)
- {
- x = -qCos(radians)*labelData.totalBounds.width();
- y = flip ? -labelData.totalBounds.width()/2.0 : -qSin(radians)*labelData.totalBounds.width()-qCos(radians)*labelData.totalBounds.height()/2.0;
- } else
- {
- x = -qCos(-radians)*labelData.totalBounds.width()-qSin(-radians)*labelData.totalBounds.height();
- y = flip ? +labelData.totalBounds.width()/2.0 : +qSin(-radians)*labelData.totalBounds.width()-qCos(-radians)*labelData.totalBounds.height()/2.0;
- }
- } else
- {
- x = -labelData.totalBounds.width();
- y = -labelData.totalBounds.height()/2.0;
- }
- } else if (mAxisType == atRight)
- {
- if (doRotation)
- {
- if (mTickLabelRotation > 0)
- {
- x = +qSin(radians)*labelData.totalBounds.height();
- y = flip ? -labelData.totalBounds.width()/2.0 : -qCos(radians)*labelData.totalBounds.height()/2.0;
- } else
- {
- x = 0;
- y = flip ? +labelData.totalBounds.width()/2.0 : -qCos(-radians)*labelData.totalBounds.height()/2.0;
- }
- } else
- {
- x = 0;
- y = -labelData.totalBounds.height()/2.0;
- }
- } else if (mAxisType == atTop)
- {
- if (doRotation)
- {
- if (mTickLabelRotation > 0)
- {
- x = -qCos(radians)*labelData.totalBounds.width()+qSin(radians)*labelData.totalBounds.height()/2.0;
- y = -qSin(radians)*labelData.totalBounds.width()-qCos(radians)*labelData.totalBounds.height();
- } else
- {
- x = -qSin(-radians)*labelData.totalBounds.height()/2.0;
- y = -qCos(-radians)*labelData.totalBounds.height();
- }
- } else
- {
- x = -labelData.totalBounds.width()/2.0;
- y = -labelData.totalBounds.height();
- }
- } else if (mAxisType == atBottom)
- {
- if (doRotation)
- {
- if (mTickLabelRotation > 0)
- {
- x = +qSin(radians)*labelData.totalBounds.height()/2.0;
- y = 0;
- } else
- {
- x = -qCos(-radians)*labelData.totalBounds.width()-qSin(-radians)*labelData.totalBounds.height()/2.0;
- y = +qSin(-radians)*labelData.totalBounds.width();
- }
- } else
- {
- x = -labelData.totalBounds.width()/2.0;
- y = 0;
- }
- }
-
- return QPointF(x, y);
- }
-
- /*! \internal
-
- Simulates the steps done by \ref placeTickLabel by calculating bounding boxes of the text label
- to be drawn, depending on number format etc. Since only the largest tick label is wanted for the
- margin calculation, the passed \a tickLabelsSize is only expanded, if it's currently set to a
- smaller width/height.
- */
- void QCPAxis::getMaxTickLabelSize(const QFont &font, const QString &text, QSize *tickLabelsSize) const
- {
- // note: this function must return the same tick label sizes as the placeTickLabel function.
- QSize finalSize;
- if (parentPlot()->plottingHints().testFlag(QCP::phCacheLabels) && mLabelCache.contains(text)) // label caching enabled and have cached label
- {
- const CachedLabel *cachedLabel = mLabelCache.object(text);
- finalSize = cachedLabel->pixmap.size();
- } else // label caching disabled or no label with this text cached:
- {
- TickLabelData labelData = getTickLabelData(font, text);
- finalSize = labelData.rotatedTotalBounds.size();
- }
-
- // expand passed tickLabelsSize if current tick label is larger:
- if (finalSize.width() > tickLabelsSize->width())
- tickLabelsSize->setWidth(finalSize.width());
- if (finalSize.height() > tickLabelsSize->height())
- tickLabelsSize->setHeight(finalSize.height());
- }
-
- /* inherits documentation from base class */
- void QCPAxis::selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged)
- {
- Q_UNUSED(event)
- SelectablePart part = details.value<SelectablePart>();
- if (mSelectableParts.testFlag(part))
- {
- SelectableParts selBefore = mSelectedParts;
- setSelectedParts(additive ? mSelectedParts^part : part);
- if (selectionStateChanged)
- *selectionStateChanged = mSelectedParts != selBefore;
- }
- }
-
- /* inherits documentation from base class */
- void QCPAxis::deselectEvent(bool *selectionStateChanged)
- {
- SelectableParts selBefore = mSelectedParts;
- setSelectedParts(mSelectedParts & ~mSelectableParts);
- if (selectionStateChanged)
- *selectionStateChanged = mSelectedParts != selBefore;
- }
-
- /*! \internal
-
- A convenience function to easily set the QPainter::Antialiased hint on the provided \a painter
- before drawing axis lines.
-
- This is the antialiasing state the painter passed to the \ref draw method is in by default.
-
- This function takes into account the local setting of the antialiasing flag as well as the
- overrides set with \ref QCustomPlot::setAntialiasedElements and \ref
- QCustomPlot::setNotAntialiasedElements.
-
- \see setAntialiased
- */
- void QCPAxis::applyDefaultAntialiasingHint(QCPPainter *painter) const
- {
- applyAntialiasingHint(painter, mAntialiased, QCP::aeAxes);
- }
-
- /*! \internal
-
- Returns via \a lowIndex and \a highIndex, which ticks in the current tick vector are visible in
- the current range. The return values are indices of the tick vector, not the positions of the
- ticks themselves.
-
- The actual use of this function is when an external tick vector is provided, since it might
- exceed far beyond the currently displayed range, and would cause unnecessary calculations e.g. of
- subticks.
-
- If all ticks are outside the axis range, an inverted range is returned, i.e. highIndex will be
- smaller than lowIndex. There is one case, where this function returns indices that are not really
- visible in the current axis range: When the tick spacing is larger than the axis range size and
- one tick is below the axis range and the next tick is already above the axis range. Because in
- such cases it is usually desirable to know the tick pair, to draw proper subticks.
- */
- void QCPAxis::visibleTickBounds(int &lowIndex, int &highIndex) const
- {
- bool lowFound = false;
- bool highFound = false;
- lowIndex = 0;
- highIndex = -1;
-
- for (int i=0; i < mTickVector.size(); ++i)
- {
- if (mTickVector.at(i) >= mRange.lower)
- {
- lowFound = true;
- lowIndex = i;
- break;
- }
- }
- for (int i=mTickVector.size()-1; i >= 0; --i)
- {
- if (mTickVector.at(i) <= mRange.upper)
- {
- highFound = true;
- highIndex = i;
- break;
- }
- }
-
- if (!lowFound && highFound)
- lowIndex = highIndex+1;
- else if (lowFound && !highFound)
- highIndex = lowIndex-1;
- }
-
- /*! \internal
-
- A log function with the base mScaleLogBase, used mostly for coordinate transforms in logarithmic
- scales with arbitrary log base. Uses the buffered mScaleLogBaseLogInv for faster calculation.
- This is set to <tt>1.0/qLn(mScaleLogBase)</tt> in \ref setScaleLogBase.
-
- \see basePow, setScaleLogBase, setScaleType
- */
- double QCPAxis::baseLog(double value) const
- {
- return qLn(value)*mScaleLogBaseLogInv;
- }
-
- /*! \internal
-
- A power function with the base mScaleLogBase, used mostly for coordinate transforms in
- logarithmic scales with arbitrary log base.
-
- \see baseLog, setScaleLogBase, setScaleType
- */
- double QCPAxis::basePow(double value) const
- {
- return qPow(mScaleLogBase, value);
- }
-
- /*! \internal
-
- Returns the pen that is used to draw the axis base line. Depending on the selection state, this
- is either mSelectedBasePen or mBasePen.
- */
- QPen QCPAxis::getBasePen() const
- {
- return mSelectedParts.testFlag(spAxis) ? mSelectedBasePen : mBasePen;
- }
-
- /*! \internal
-
- Returns the pen that is used to draw the (major) ticks. Depending on the selection state, this
- is either mSelectedTickPen or mTickPen.
- */
- QPen QCPAxis::getTickPen() const
- {
- return mSelectedParts.testFlag(spAxis) ? mSelectedTickPen : mTickPen;
- }
-
- /*! \internal
-
- Returns the pen that is used to draw the subticks. Depending on the selection state, this
- is either mSelectedSubTickPen or mSubTickPen.
- */
- QPen QCPAxis::getSubTickPen() const
- {
- return mSelectedParts.testFlag(spAxis) ? mSelectedSubTickPen : mSubTickPen;
- }
-
- /*! \internal
-
- Returns the font that is used to draw the tick labels. Depending on the selection state, this
- is either mSelectedTickLabelFont or mTickLabelFont.
- */
- QFont QCPAxis::getTickLabelFont() const
- {
- return mSelectedParts.testFlag(spTickLabels) ? mSelectedTickLabelFont : mTickLabelFont;
- }
-
- /*! \internal
-
- Returns the font that is used to draw the axis label. Depending on the selection state, this
- is either mSelectedLabelFont or mLabelFont.
- */
- QFont QCPAxis::getLabelFont() const
- {
- return mSelectedParts.testFlag(spAxisLabel) ? mSelectedLabelFont : mLabelFont;
- }
-
- /*! \internal
-
- Returns the color that is used to draw the tick labels. Depending on the selection state, this
- is either mSelectedTickLabelColor or mTickLabelColor.
- */
- QColor QCPAxis::getTickLabelColor() const
- {
- return mSelectedParts.testFlag(spTickLabels) ? mSelectedTickLabelColor : mTickLabelColor;
- }
-
- /*! \internal
-
- Returns the color that is used to draw the axis label. Depending on the selection state, this
- is either mSelectedLabelColor or mLabelColor.
- */
- QColor QCPAxis::getLabelColor() const
- {
- return mSelectedParts.testFlag(spAxisLabel) ? mSelectedLabelColor : mLabelColor;
- }
-
- /*! \internal
-
- Returns the appropriate outward margin for this axis. It is needed if \ref
- QCPAxisRect::setAutoMargins is set to true on the parent axis rect. An axis with axis type \ref
- atLeft will return an appropriate left margin, \ref atBottom will return an appropriate bottom
- margin and so forth. For the calculation, this function goes through similar steps as \ref draw,
- so changing one function likely requires the modification of the other one as well.
-
- The margin consists of the outward tick length, tick label padding, tick label size, label
- padding, label size, and padding.
-
- The margin is cached internally, so repeated calls while leaving the axis range, fonts, etc.
- unchanged are very fast.
- */
- int QCPAxis::calculateMargin()
- {
- if (mCachedMarginValid)
- return mCachedMargin;
-
- // run through similar steps as QCPAxis::draw, and caluclate margin needed to fit axis and its labels
- int margin = 0;
-
- if (mVisible)
- {
- int lowTick, highTick;
- visibleTickBounds(lowTick, highTick);
- // get length of tick marks pointing outwards:
- if (mTicks)
- margin += qMax(0, qMax(mTickLengthOut, mSubTickLengthOut));
- // calculate size of tick labels:
- QSize tickLabelsSize(0, 0);
- if (mTickLabels)
- {
- for (int i=lowTick; i<=highTick; ++i)
- getMaxTickLabelSize(mTickLabelFont, mTickVectorLabels.at(i), &tickLabelsSize); // don't use getTickLabelFont() because we don't want margin to possibly change on selection
- margin += orientation() == Qt::Horizontal ? tickLabelsSize.height() : tickLabelsSize.width();
- margin += mTickLabelPadding;
- }
- // calculate size of axis label (only height needed, because left/right labels are rotated by 90 degrees):
- if (!mLabel.isEmpty())
- {
- QFontMetrics fontMetrics(mLabelFont); // don't use getLabelFont() because we don't want margin to possibly change on selection
- QRect bounds;
- bounds = fontMetrics.boundingRect(0, 0, 0, 0, Qt::TextDontClip | Qt::AlignHCenter | Qt::AlignVCenter, mLabel);
- margin += bounds.height() + mLabelPadding;
- }
- }
- margin += mPadding;
-
- mCachedMargin = margin;
- mCachedMarginValid = true;
- return margin;
- }
-
- /* inherits documentation from base class */
- QCP::Interaction QCPAxis::selectionCategory() const
- {
- return QCP::iSelectAxes;
- }
-
-
- ////////////////////////////////////////////////////////////////////////////////////////////////////
- //////////////////// QCPAbstractPlottable
- ////////////////////////////////////////////////////////////////////////////////////////////////////
-
- /*! \class QCPAbstractPlottable
- \brief The abstract base class for all data representing objects in a plot.
-
- It defines a very basic interface like name, pen, brush, visibility etc. Since this class is
- abstract, it can't be instantiated. Use one of the subclasses or create a subclass yourself to
- create new ways of displaying data (see "Creating own plottables" below).
-
- All further specifics are in the subclasses, for example:
- \li A normal graph with possibly a line, scatter points and error bars is displayed by \ref QCPGraph
- (typically created with \ref QCustomPlot::addGraph).
- \li A parametric curve can be displayed with \ref QCPCurve.
- \li A stackable bar chart can be achieved with \ref QCPBars.
- \li A box of a statistical box plot is created with \ref QCPStatisticalBox.
-
- \section plottables-subclassing Creating own plottables
-
- To create an own plottable, you implement a subclass of QCPAbstractPlottable. These are the pure
- virtual functions, you must implement:
- \li \ref clearData
- \li \ref selectTest
- \li \ref draw
- \li \ref drawLegendIcon
- \li \ref getKeyRange
- \li \ref getValueRange
-
- See the documentation of those functions for what they need to do.
-
- For drawing your plot, you can use the \ref coordsToPixels functions to translate a point in plot
- coordinates to pixel coordinates. This function is quite convenient, because it takes the
- orientation of the key and value axes into account for you (x and y are swapped when the key axis
- is vertical and the value axis horizontal). If you are worried about performance (i.e. you need
- to translate many points in a loop like QCPGraph), you can directly use \ref
- QCPAxis::coordToPixel. However, you must then take care about the orientation of the axis
- yourself.
-
- Here are some important members you inherit from QCPAbstractPlottable:
- <table>
- <tr>
- <td>QCustomPlot *\b mParentPlot</td>
- <td>A pointer to the parent QCustomPlot instance. The parent plot is inferred from the axes that are passed in the constructor.</td>
- </tr><tr>
- <td>QString \b mName</td>
- <td>The name of the plottable.</td>
- </tr><tr>
- <td>QPen \b mPen</td>
- <td>The generic pen of the plottable. You should use this pen for the most prominent data representing lines in the plottable (e.g QCPGraph uses this pen for its graph lines and scatters)</td>
- </tr><tr>
- <td>QPen \b mSelectedPen</td>
- <td>The generic pen that should be used when the plottable is selected (hint: \ref mainPen gives you the right pen, depending on selection state).</td>
- </tr><tr>
- <td>QBrush \b mBrush</td>
- <td>The generic brush of the plottable. You should use this brush for the most prominent fillable structures in the plottable (e.g. QCPGraph uses this brush to control filling under the graph)</td>
- </tr><tr>
- <td>QBrush \b mSelectedBrush</td>
- <td>The generic brush that should be used when the plottable is selected (hint: \ref mainBrush gives you the right brush, depending on selection state).</td>
- </tr><tr>
- <td>QPointer<QCPAxis>\b mKeyAxis, \b mValueAxis</td>
- <td>The key and value axes this plottable is attached to. Call their QCPAxis::coordToPixel functions to translate coordinates to pixels in either the key or value dimension.
- Make sure to check whether the weak pointer is null before using it. If one of the axes is null, don't draw the plottable.</td>
- </tr><tr>
- <td>bool \b mSelected</td>
- <td>indicates whether the plottable is selected or not.</td>
- </tr>
- </table>
- */
-
- /* start of documentation of pure virtual functions */
-
- /*! \fn void QCPAbstractPlottable::clearData() = 0
- Clears all data in the plottable.
- */
-
- /*! \fn void QCPAbstractPlottable::drawLegendIcon(QCPPainter *painter, const QRect &rect) const = 0
- \internal
-
- called by QCPLegend::draw (via QCPPlottableLegendItem::draw) to create a graphical representation
- of this plottable inside \a rect, next to the plottable name.
- */
-
- /*! \fn QCPRange QCPAbstractPlottable::getKeyRange(bool &validRange, SignDomain inSignDomain) const = 0
- \internal
-
- called by rescaleAxes functions to get the full data key bounds. For logarithmic plots, one can
- set \a inSignDomain to either \ref sdNegative or \ref sdPositive in order to restrict the
- returned range to that sign domain. E.g. when only negative range is wanted, set \a inSignDomain
- to \ref sdNegative and all positive points will be ignored for range calculation. For no
- restriction, just set \a inSignDomain to \ref sdBoth (default). \a validRange is an output
- parameter that indicates whether a proper range could be found or not. If this is false, you
- shouldn't use the returned range (e.g. no points in data).
-
- \see rescaleAxes, getValueRange
- */
-
- /*! \fn QCPRange QCPAbstractPlottable::getValueRange(bool &validRange, SignDomain inSignDomain) const = 0
- \internal
-
- called by rescaleAxes functions to get the full data value bounds. For logarithmic plots, one can
- set \a inSignDomain to either \ref sdNegative or \ref sdPositive in order to restrict the
- returned range to that sign domain. E.g. when only negative range is wanted, set \a inSignDomain
- to \ref sdNegative and all positive points will be ignored for range calculation. For no
- restriction, just set \a inSignDomain to \ref sdBoth (default). \a validRange is an output
- parameter that indicates whether a proper range could be found or not. If this is false, you
- shouldn't use the returned range (e.g. no points in data).
-
- \see rescaleAxes, getKeyRange
- */
-
- /* end of documentation of pure virtual functions */
- /* start of documentation of signals */
-
- /*! \fn void QCPAbstractPlottable::selectionChanged(bool selected)
-
- This signal is emitted when the selection state of this plottable has changed to \a selected,
- either by user interaction or by a direct call to \ref setSelected.
- */
-
- /* end of documentation of signals */
-
- /*!
- Constructs an abstract plottable which uses \a keyAxis as its key axis ("x") and \a valueAxis as
- its value axis ("y"). \a keyAxis and \a valueAxis must reside in the same QCustomPlot instance
- and have perpendicular orientations. If either of these restrictions is violated, a corresponding
- message is printed to the debug output (qDebug), the construction is not aborted, though.
-
- Since QCPAbstractPlottable is an abstract class that defines the basic interface to plottables,
- it can't be directly instantiated.
-
- You probably want one of the subclasses like \ref QCPGraph or \ref QCPCurve instead.
- */
- QCPAbstractPlottable::QCPAbstractPlottable(QCPAxis *keyAxis, QCPAxis *valueAxis) :
- QCPLayerable(keyAxis->parentPlot(), "", keyAxis->axisRect()),
- mName(""),
- mAntialiasedFill(true),
- mAntialiasedScatters(true),
- mAntialiasedErrorBars(false),
- mPen(Qt::black),
- mSelectedPen(Qt::black),
- mBrush(Qt::NoBrush),
- mSelectedBrush(Qt::NoBrush),
- mKeyAxis(keyAxis),
- mValueAxis(valueAxis),
- mSelectable(true),
- mSelected(false)
- {
- if (keyAxis->parentPlot() != valueAxis->parentPlot())
- qDebug() << Q_FUNC_INFO << "Parent plot of keyAxis is not the same as that of valueAxis.";
- if (keyAxis->orientation() == valueAxis->orientation())
- qDebug() << Q_FUNC_INFO << "keyAxis and valueAxis must be orthogonal to each other.";
- }
-
- /*!
- The name is the textual representation of this plottable as it is displayed in the legend
- (\ref QCPLegend). It may contain any UTF-8 characters, including newlines.
- */
- void QCPAbstractPlottable::setName(const QString &name)
- {
- mName = name;
- }
-
- /*!
- Sets whether fills of this plottable is drawn antialiased or not.
-
- Note that this setting may be overridden by \ref QCustomPlot::setAntialiasedElements and \ref
- QCustomPlot::setNotAntialiasedElements.
- */
- void QCPAbstractPlottable::setAntialiasedFill(bool enabled)
- {
- mAntialiasedFill = enabled;
- }
-
- /*!
- Sets whether the scatter symbols of this plottable are drawn antialiased or not.
-
- Note that this setting may be overridden by \ref QCustomPlot::setAntialiasedElements and \ref
- QCustomPlot::setNotAntialiasedElements.
- */
- void QCPAbstractPlottable::setAntialiasedScatters(bool enabled)
- {
- mAntialiasedScatters = enabled;
- }
-
- /*!
- Sets whether the error bars of this plottable are drawn antialiased or not.
-
- Note that this setting may be overridden by \ref QCustomPlot::setAntialiasedElements and \ref
- QCustomPlot::setNotAntialiasedElements.
- */
- void QCPAbstractPlottable::setAntialiasedErrorBars(bool enabled)
- {
- mAntialiasedErrorBars = enabled;
- }
-
-
- /*!
- The pen is used to draw basic lines that make up the plottable representation in the
- plot.
-
- For example, the \ref QCPGraph subclass draws its graph lines and scatter points
- with this pen.
-
- \see setBrush
- */
- void QCPAbstractPlottable::setPen(const QPen &pen)
- {
- mPen = pen;
- }
-
- /*!
- When the plottable is selected, this pen is used to draw basic lines instead of the normal
- pen set via \ref setPen.
-
- \see setSelected, setSelectable, setSelectedBrush, selectTest
- */
- void QCPAbstractPlottable::setSelectedPen(const QPen &pen)
- {
- mSelectedPen = pen;
- }
-
- /*!
- The brush is used to draw basic fills of the plottable representation in the
- plot. The Fill can be a color, gradient or texture, see the usage of QBrush.
-
- For example, the \ref QCPGraph subclass draws the fill under the graph with this brush, when
- it's not set to Qt::NoBrush.
-
- \see setPen
- */
- void QCPAbstractPlottable::setBrush(const QBrush &brush)
- {
- mBrush = brush;
- }
-
- /*!
- When the plottable is selected, this brush is used to draw fills instead of the normal
- brush set via \ref setBrush.
-
- \see setSelected, setSelectable, setSelectedPen, selectTest
- */
- void QCPAbstractPlottable::setSelectedBrush(const QBrush &brush)
- {
- mSelectedBrush = brush;
- }
-
- /*!
- The key axis of a plottable can be set to any axis of a QCustomPlot, as long as it is orthogonal
- to the plottable's value axis. This function performs no checks to make sure this is the case.
- The typical mathematical choice is to use the x-axis (QCustomPlot::xAxis) as key axis and the
- y-axis (QCustomPlot::yAxis) as value axis.
-
- Normally, the key and value axes are set in the constructor of the plottable (or \ref
- QCustomPlot::addGraph when working with QCPGraphs through the dedicated graph interface).
-
- \see setValueAxis
- */
- void QCPAbstractPlottable::setKeyAxis(QCPAxis *axis)
- {
- mKeyAxis = axis;
- }
-
- /*!
- The value axis of a plottable can be set to any axis of a QCustomPlot, as long as it is
- orthogonal to the plottable's key axis. This function performs no checks to make sure this is the
- case. The typical mathematical choice is to use the x-axis (QCustomPlot::xAxis) as key axis and
- the y-axis (QCustomPlot::yAxis) as value axis.
-
- Normally, the key and value axes are set in the constructor of the plottable (or \ref
- QCustomPlot::addGraph when working with QCPGraphs through the dedicated graph interface).
-
- \see setKeyAxis
- */
- void QCPAbstractPlottable::setValueAxis(QCPAxis *axis)
- {
- mValueAxis = axis;
- }
-
- /*!
- Sets whether the user can (de-)select this plottable by clicking on the QCustomPlot surface.
- (When \ref QCustomPlot::setInteractions contains iSelectPlottables.)
-
- However, even when \a selectable was set to false, it is possible to set the selection manually,
- by calling \ref setSelected directly.
-
- \see setSelected
- */
- void QCPAbstractPlottable::setSelectable(bool selectable)
- {
- mSelectable = selectable;
- }
-
- /*!
- Sets whether this plottable is selected or not. When selected, it uses a different pen and brush
- to draw its lines and fills, see \ref setSelectedPen and \ref setSelectedBrush.
-
- The entire selection mechanism for plottables is handled automatically when \ref
- QCustomPlot::setInteractions contains iSelectPlottables. You only need to call this function when
- you wish to change the selection state manually.
-
- This function can change the selection state even when \ref setSelectable was set to false.
-
- emits the \ref selectionChanged signal when \a selected is different from the previous selection state.
-
- \see setSelectable, selectTest
- */
- void QCPAbstractPlottable::setSelected(bool selected)
- {
- if (mSelected != selected)
- {
- mSelected = selected;
- emit selectionChanged(mSelected);
- }
- }
-
- /*!
- Rescales the key and value axes associated with this plottable to contain all displayed data, so
- the whole plottable is visible. If the scaling of an axis is logarithmic, rescaleAxes will make
- sure not to rescale to an illegal range i.e. a range containing different signs and/or zero.
- Instead it will stay in the current sign domain and ignore all parts of the plottable that lie
- outside of that domain.
-
- \a onlyEnlarge makes sure the ranges are only expanded, never reduced. So it's possible to show
- multiple plottables in their entirety by multiple calls to rescaleAxes where the first call has
- \a onlyEnlarge set to false (the default), and all subsequent set to true.
-
- \see rescaleKeyAxis, rescaleValueAxis, QCustomPlot::rescaleAxes, QCPAxis::rescale
- */
- void QCPAbstractPlottable::rescaleAxes(bool onlyEnlarge) const
- {
- rescaleKeyAxis(onlyEnlarge);
- rescaleValueAxis(onlyEnlarge);
- }
-
- /*!
- Rescales the key axis of the plottable so the whole plottable is visible.
-
- See \ref rescaleAxes for detailed behaviour.
- */
- void QCPAbstractPlottable::rescaleKeyAxis(bool onlyEnlarge) const
- {
- QCPAxis *keyAxis = mKeyAxis.data();
- if (!keyAxis) { qDebug() << Q_FUNC_INFO << "invalid key axis"; return; }
-
- SignDomain signDomain = sdBoth;
- if (keyAxis->scaleType() == QCPAxis::stLogarithmic)
- signDomain = (keyAxis->range().upper < 0 ? sdNegative : sdPositive);
-
- bool rangeValid;
- QCPRange newRange = getKeyRange(rangeValid, signDomain);
- if (rangeValid)
- {
- if (onlyEnlarge)
- newRange.expand(keyAxis->range());
- keyAxis->setRange(newRange);
- }
- }
-
- /*!
- Rescales the value axis of the plottable so the whole plottable is visible.
-
- Returns true if the axis was actually scaled. This might not be the case if this plottable has an
- invalid range, e.g. because it has no data points.
-
- See \ref rescaleAxes for detailed behaviour.
- */
- void QCPAbstractPlottable::rescaleValueAxis(bool onlyEnlarge) const
- {
- QCPAxis *valueAxis = mValueAxis.data();
- if (!valueAxis) { qDebug() << Q_FUNC_INFO << "invalid value axis"; return; }
-
- SignDomain signDomain = sdBoth;
- if (valueAxis->scaleType() == QCPAxis::stLogarithmic)
- signDomain = (valueAxis->range().upper < 0 ? sdNegative : sdPositive);
-
- bool rangeValid;
- QCPRange newRange = getValueRange(rangeValid, signDomain);
- if (rangeValid)
- {
- if (onlyEnlarge)
- newRange.expand(valueAxis->range());
- valueAxis->setRange(newRange);
- }
- }
-
- /*!
- Adds this plottable to the legend of the parent QCustomPlot (QCustomPlot::legend).
-
- Normally, a QCPPlottableLegendItem is created and inserted into the legend. If the plottable
- needs a more specialized representation in the legend, this function will take this into account
- and instead create the specialized subclass of QCPAbstractLegendItem.
-
- Returns true on success, i.e. when the legend exists and a legend item associated with this plottable isn't already in
|